Top / monazilla / develop / shitaraba

したらばBBS

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

最近、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


トップ   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS