FiveCh Bot API

X-Session-Id: {parentSessionId}
Content-Type: application/json

• GET/api/state現在の親セッション状態、表示中の子セッション状態、投稿設定、端末設定。
• POST/api/state/postingrole別の投稿User-Agent/Cookie設定。
• POST/api/state/bridge-devicesmain/sub端末IDの全体設定。
• GET/api/logsUI/appログ取得。
• POST/api/logsUI/appログ追加。
• POST/api/chbot/iprole別GetIP。
• POST/api/chbot/change_iprole別ChangeIP。
• GET/api/admin/cost今月コスト取得。
• GET/api/admin/creditGmailの最新チャージ通知を基準にした残量推定。
• POST/api/session/new親セッション作成。
• GET/api/sessions親セッション一覧。
• DELETE/api/sessions/{sid}親セッション削除。
• GET/api/debug/id-sourceID検出デバッグ。
• POST/api/state/guideローカルガイド設定。/api/state/guide/local と同じ。
• POST/api/state/guide/localrole別ローカルガイド設定。
• POST/api/state/guide/global返信モード別グローバルガイド設定。
• POST/api/state/fixedreply全セッション共有の固定文言設定。
• POST/api/state/confirm廃止済み。常にOFF固定。
• POST/api/state/hideprompt廃止済み。常にOFF固定。
• POST/api/state/reasoningeffortrole別reasoning effort設定。
• POST/api/state/replymoderole別リプライモード設定。
• POST/api/state/lineWeb UI表示中の子セッション切替。
• POST/api/state/autochgiprole別、投稿ごとChangeIP設定。
• POST/api/state/scanignoreothersrole別、スキャン時の他者アンカー無視設定。
• POST/api/state/randomnamerole別ランダム名前ON/OFF。
• POST/api/state/randomname/poolrole別ランダム名前プール設定。
• POST/api/state/randomname/moderole別ランダム名前モード設定。
• POST/api/state/randomname/formatrole別英数字名前フォーマット設定。
• POST/api/state/randomname/jpformatrole別日本語名前フォーマット設定。
• POST/api/targets/listrole別相手ID一覧。
• POST/api/targets/addrole別相手ID追加。
• POST/api/targets/delrole別相手ID削除。
• GET/api/myidmain/sub両方のMyID取得。
• POST/api/myid/setrole別MyID設定。
• POST/api/myid/clearrole別MyIDクリア。
• POST/api/generaterole別生成。
• POST/api/postrole別投稿。
• POST/api/auto/scanrole別自動スキャン。
• POST/api/auto/queuerole別自動キュー取得。
• POST/api/auto/hostility-reasonsrole別敵意判定理由取得。
• POST/api/auto/clearrole別自動キュー/状態クリア。
• POST/api/auto/nextrole別次候補取得。
• POST/api/auto/actionrole別自動候補操作。
• POST/api/auto/watch/statusrole別監視状態取得。
• POST/api/auto/watch/startrole別監視開始。
• POST/api/auto/watch/stoprole別監視停止。

パラメータ

• threadUrl対象スレURL。通常は5chのread.cgi URL。topVip=true の場合はTop VIPから解決。
• topViptrue なら現行Top VIPスレを使う。通常は false。
• sid任意の親セッションID。省略するとサーバーが自動生成。8から64文字の英数字、ハイフン、アンダースコア。
• lineRole作成直後に選択する回線。main または sub。親セッション作成時点で両方の子セッションは作られる。
• running/api/sessions の絞り込み。0 または false で全件、未指定は監視中のみ。

主なレスポンス項目

• sessionId親セッションID。以後 X-Session-Id に指定する。
• activeLineRoleWeb UIで表示中の子セッション。
• fixedReplyText固定文言モードで使う全セッション共有の投稿本文。未設定またはリセット時は なるほどな。
• main / sub/api/sessions では各子セッションのMyIDと監視状態を返す。

GET /api/myid
X-Session-Id: {parentSessionId}

{
  "ok": true,
  "sessionId": "親セッションID",
  "threadUrl": "...",
  "threadTitle": "...",
  "activeLineRole": "main",
  "ids": ["ID:xxx", "ID:yyy"],
  "myIds": ["ID:xxx", "ID:yyy"],
  "mainIds": ["ID:xxx"],
  "subIds": ["ID:yyy"],
  "main": {
    "lineRole": "main",
    "ids": ["ID:xxx"],
    "myIds": ["ID:xxx"]
  },
  "sub": {
    "lineRole": "sub",
    "ids": ["ID:yyy"],
    "myIds": ["ID:yyy"]
  }
}

パラメータ

• role設定またはクリアする子セッション。main または sub。
• idMyID文字列。ID:abc をスペース区切り、改行区切り、カンマ区切りで複数指定可能。
• X-Session-Id親セッションID。レスポンスには main/sub 両方のMyIDが含まれる。

主なレスポンス項目

• ids / myIdsmainIds と subIds をまとめた全MyID一覧。
• mainIdsmain 子セッションのMyID一覧。
• subIdssub 子セッションのMyID一覧。
• main / sub各回線ごとの lineRole、ids、myIds。

パラメータ / レスポンス

• role相手IDを登録または取得する子セッション。
• id相手の投稿ID。例: ID:target。
• targets現在登録されている相手ID一覧。

パラメータ

• rolemain または sub。投稿設定や自動処理の対象回線。
• userAgent5ch投稿時のUser-Agent。空文字なら未設定。
• postCookie5ch投稿時のCookie。例: MonaTicket=...。空文字なら未設定。
• mainDevicemain回線で使う端末ID。全親セッション共通設定。
• subDevicesub回線で使う端末ID。未設定時はmain側設定にフォールバック。

パラメータ

• modeagitating, normal, fixed など。固定文言モードは fixed。
• effortnone, minimal, low, medium, high など。
• cleartrue でガイドまたはプールをクリア。/api/state/fixedreply では既定文言 なるほどな に戻す。
• valueON/OFF系設定。true または false。

生成パラメータ

• role生成または投稿に使う子セッション。main または sub。
• threadUrl対象スレURL。null または省略でセッションに保存済みのスレを使う。
• resNo返信対象レス番号。1以上。
• extraGuidance追加指示。空文字可。セッションのガイドがある場合は自動で合成される。
• includePrompt現在は値に関係なくプロンプト返却ON。
• model生成モデルの一時上書き。null ならサーバー既定。
• reasoningEffortnone, minimal, low, medium, high など。null ならセッション設定。

投稿パラメータ / レスポンス

• message投稿本文。必須。
• resNo返信対象レス番号。投稿履歴や自動キュー除外に使う。
• draft生成された投稿案。
• promptSent生成時に実際に送ったプロンプト。
• statusCode投稿先から返ったHTTPステータス。
• posterIdPrefix投稿後に検出した自分のID。MyIDへ自動追加される。

パラメータ

• rolemain または sub。queryまたはJSONで指定。
• fromResNoスキャン開始レス番号。null ならセッション状態から自動決定。
• sessionId/api/auto/next が返す自動候補ID。親セッションIDとは別。
• actionpost: 投稿、skip: スキップ、quit: キューに戻す、regen: 再生成、addregen: 追記して再生成。
• addTextaddregen で追加する指示文。それ以外では null 可。

主なレスポンス項目

• addedスキャンでキューに追加された件数。
• queueCount現在のキュー件数。
• hostilities敵意判定の結果一覧。レス番号、ID、スコア、理由を含む。
• draft自動候補の生成文。
• status自動操作結果。例: posted, skipped, regenerated。

パラメータ / レスポンス

• role監視対象回線。main または sub。両方を並行起動できる。
• minScanIntervalSeconds最短スキャン間隔秒。
• maxScanIntervalSeconds最長スキャン間隔秒。min以上にする。
• autoPosttrue なら生成後に自動投稿まで行う。
• postDelaySeconds自動投稿前の待機秒数。
• running監視中かどうか。
• cycles監視ループ実行回数。
• lastNote直近の監視メモまたはエラー。