Futaboard 仕様書（DAT / カタログ / JSON API） 2025-10-24 JST

この文書は DAT 形式 と api.php の仕様を説明しています。

1. 概要

2. DAT 仕様

DAT は 「<>」区切りのテキスト行 の集合です。1 行が 1 レスに対応します。スレッド DAT では、

• 先頭から 固定 17 フィールド（#0〜#16） を持ちます。
• 親投稿（スレ立て行）のみ、行末側に 拡張 2 フィールド（#17, #18） が付与されます。
• 拡張部の先頭は <status> というマーカーで識別されます（親行のみ）。

サンプルURL

• 各板のディレクトリにcatalog.datを付加しアクセスするとスレッド一覧を取得できます(サンプル：http://board.futakuro.com/may/catalog.dat)
• 各スレッドの拡張子をhtmからdatに変更するとレス一覧を取得できます(サンプル：http://board.futakuro.com/sup/res/1.dat)

2.1 スレッド DAT：各フィールド定義

* #17〜#18 は親行のみ。子レスには存在しません。

2.2 catalog.dat：各行の定義

カタログ行はスレ概要用の簡易形式です。1 行の並びは以下です。

スレ番号はパス（例：/res/<no>.htm）から抽出されます。

3. api.php 仕様

サンプルURL

• http://board.futakuro.com/may/api.php?mode=jsonにアクセスするとmayのカタログを取得できます。
• http://board.futakuro.com/may/api.php?mode=json&res=スレッド番号&start=取得開始レスにアクセスするとmayの取得開始レス以降についた新着レスを取得できます

3.1 エンドポイント

3.2 クエリパラメータ

mode（必須 / スレッド取得時のみ）

文字列 json 固定。

res（必須 / スレッド取得時）

スレッド番号（整数）。

start（任意）

取得を開始するレス番号。その番号のレスは含まれます（例：start=1 でも #1 を含む）。未指定は 0 で全件。

3.3 共通レスポンス（トップレベル）

3.4 res 内のレス項目（スレッド JSON）

3.5 res 内の項目（カタログ JSON）

カタログでは、各スレが「レス相当の 1 レコード」として返ります。カタログ特有の差分は以下です。

3.6 エラー時の応答

不正なクエリ（例：mode が不正、res が未指定/0）に対しては、HTTP 200 で以下のような JSON を返すことがあります。

{
  "old": 0,
  "res": {},
  "sd": {},
  "error": "Invalid parameters."
}

4. 利用例

4.1 カタログ取得

GET /api.php?mode=json

{
  "old": 1,
  "dispname": 1,
  "dispsod": 1,
  "die": "24日12:00",
  "dielong": "Fri, 24 Oct 2025 03:00:00 GMT",
  "nowtime": 1761234000,
  "maxres": "",
  "res": {
    "123456": {
      "now": "2025/10/24(金) 12:00:00",
      "name": "",
      "email": "",
      "sub": "お知らせスレ",
      "com": "本文の先頭…",
      "ext": "",
      "w": 200, "h": 200,
      "tim": "1761234000000",
      "fsize": 0,
      "del": "", "host": "", "id": "",
      "rsc": 12,
      "src": "",
      "thumb": "https://example.com/thumb/abcdefs.jpg",
      "srcw": 1024, "srch": 768
    }
  },
  "sd": {}
}

4.2 スレッド取得（全件）

GET /api.php?mode=json&res=123456

{
  "old": 0,
  "dispname": 1,
  "dispsod": 1,
  "die": "25日10:30",
  "dielong": "Sat, 25 Oct 2025 01:30:00 GMT",
  "nowtime": 1761320400,
  "maxres": "",
  "res": {
    "1": {
      "now": "2025/10/24(金) 12:00:00 ID:abcd1234",
      "name": "名無しさん",
      "email": "sage",
      "sub": "お知らせスレ",
      "com": "本文…<br>続き",
      "ext": ".jpg",
      "w": 1024, "h": 768,
      "tim": "1761234000000",
      "fsize": 345678,
      "del": "", "host": "",
      "id": "abcd1234",
      "rsc": 1,
      "src": "https://example.com/img/abcdef.jpg",
      "thumb": "https://example.com/thumb/abcdefs.jpg"
    },
    "2": { "now": "…", "name": "…", "...": "…" }
  },
  "sd": { "0": 0, "1": 3, "2": 0, "3": 1 }
}

4.3 スレッド取得（start 指定）

GET /api.php?mode=json&res=123456&start=100

レス #100 以降のみを res に含めます。sd はスレ全件分（#0 を含む場合あり）です。

5. 補足・互換性

• UNIX 時刻の単位：DAT 内やカタログの時刻は「秒」または「ミリ秒」で表現される場合があります。API の tim はミリ秒に正規化されます。
• URL の形式：API は相対 URL を絶対 URL に変換して返します（空の場合は空のまま）。
• フィールドの欠落：子レスでは #16〜#18 が無いのが通常です。クライアントは存在チェックを行ってください。
• 表示ヒント（dispname / dispsod）：UI 向けのアドバイスであり、必須ではありません。