Monazilla/develop/shitaraba

したらばBBS

注意: jbbs.livedoor.jp → jbbs.shitaraba.net に掲示板が移転しているため、読み替えが必要となります

したらば掲示板”専用ブラウザ開発者様へのお知らせ”

オリジナル: http://blog.livedoor.jp/bbsnews/archives/50283526.html

最近、2chブラウザ利用ユーザから問い合わせが増えてきており、
問合せ内容の調査の結果「read.cgi」経由でデータを取得しているソフトが多いことが判りました。

したらばでは 「read.cgi」よりサーバの側処理コストが低く、フォーマットも単純な
「rawmode.cgi」を 2ch専用ブラウザソフト向けに提供しております。

「read.cgi」 は近々に予定している機能修正などで HTML が変更されます。
「rawmode.cgi」をお使い頂く事で「read.cgi」側の変更に影響されない作りにする事が可能となりますので
是非、下記をご参考下さい。

★ rawmode.cgi について

アクセス先を read.cgi から rawmode.cgi に変更することで
2ch の dat フォーマットに似た形式でデータを取得することが可能です。

/bbs/rawmode.cgi/[カテゴリ]/[掲示板番号]/[スレッド番号]/[オプション]

■ オプション

オプション部分で、取得したい個別レスや指定方法・件数などを指定します。

• 単一レスの取得

[NN] 数字のみ

取得したいレス番号を指定

例) /bbs/rawmode.cgi/computer/10298/1158291064/123

• 範囲指定(終端在り)

[XX]-[YY]

レス番号を - で繋ぐ事でその範囲を取得

例) /bbs/rawmode.cgi/computer/10298/1158291064/123-125

• 範囲指定(終端無し)

[NN]-

レス番号の後に - を付けることでその番号以降を全て取得

例) /bbs/rawmode.cgi/computer/10298/1158291064/250-

• 最新 NN レスを取得

l[NN]

lの後に取得したい件数を指定することで任意の件数の最新レスを取得

例) /bbs/rawmode.cgi/computer/10298/1158291064/l2

※ 一番目のレスが不要な場合は最後に "n" を付ける事でスキップ可能です。

■ レスポンス

• 正常取得

正常に取得できた場合、レス数分の行が返されます。

一行のデータフォーマットは下記のようになります。

[レス番号]<>[名前]<>[メール]<>[日付]<>[本文]<>[スレッドタイトル]<>[ID]

※ デリミタは <>
※ 一レスは一行で、改行コード は LF
※ スレッドタイトルは 基本的に一番目のレスだけに存在

• 取得失敗 (エラーレスポンス)

データが無い場合やパラメータが間違っている場合は

HTTP レスポンスヘッダにてエラー通知を行ないます。

ヘッダに ERROR: フィールドがあれば何らかのエラーです。

• ERROR: BBS NOT FOUND

掲示板番号が不正

パラメータが間違っています。

• ERROR: KEY NOT FOUND

スレッド番号が不正

パラメータが間違っています。

• ERROR: THREAD NOT FOUND

該当するスレッドは存在しない

URLが間違っているか 過去ログに移動せずに削除された場合です。

• ERROR: STORAGE IN

過去ログとして存在

該当のスレッドは、データ削除の後、過去ログ倉庫に移動されています。

※この場合、以下のURLで過去ログ(静的なHTMLファイル)にアクセスすることが可能です。
http://jbbs.livedoor.jp/[カテゴリ]/[掲示板番号]/storage/[スレッド番号].html

掲示板情報を取得する為のAPIを公開

オリジナル: http://blog.livedoor.jp/bbsnews/archives/cat_10007512.html

いつもしたらば掲示板をご利用いただきまして、ありがとうございます。

専用ブラウザ等の外部アプリケーション向けに、各掲示板の設定情報を取得できる API を公開致しました。
下記の形式でアクセスすることで 2ch の SETTING.TXT と似た形式でいくつかの情報を取得できます。
　http://jbbs.livedoor.jp/bbs/api/setting.cgi/[カテゴリ]/[番地]/

項目は下記になります。

TOP=掲示板のURL
DIR=カテゴリ
BBS=番地
CATEGORY=カテゴリ名(日本語名)
BBS_THREAD_STOP=１スレッドに書き込めるレスの上限数
BBS_NONAME_NAME=名無しさんの名前
BBS_DELETE_NAME=削除されたレスに付く名前(あぼーん名)
BBS_TITLE=掲示板タイトル
BBS_COMMENT=掲示板の説明文

※項目は、将来的に変更や削除が行われる可能性があります。

レコードは改行(LF)区切りで、KEY=VALUE の形式となっております。
最初に出現する "=" までが KEY になり、VALUE 中にも "=" が入る場合があります。
また、キャラクターセットは EUC-JP です。
尚、何らかのエラー(存在しない、休止中等)の場合は「ERROR=エラーメッセージ」が返ります。

現在、２ちゃんねる専用ブラウザ「Jane Style」がこの API を使用して、したらば掲示板の外部版登録機能を提供しています。