API

v2.0.0 · 543 件

BOUNTY の画面が使っているのと同じ HTTP の API を、分類ごとに並べている。分類の行を押すと、頁を移らずに右（スマホは下）にその分類の API が開き、さらに行を押すと送るもの・返るもの・例つきの詳細に切り替わる。閉じると一覧の同じ位置に戻る。

はじめに

ベース URL

すべての API はこのドメインの下にある。パスはこの頁と各分類の頁に書いてあるとおりに付ける。

https://bounty.spikes.4s.link

認証

呼び方は次のとおり。「ログイン」はブラウザやアプリでログインした本人として呼ぶもの（クッキーかアプリのセッション）。「トークン」は外のサービスや AI から、トークン（MCP のログインで受け取るもの、または発行した API トークン）を付けて呼ぶもの。「認証なし」は誰でも読める公開の情報。

ログイン 493 件・認証なし 45 件・トークン 5 件

エラー

失敗したときは HTTP の状態コードと、次の形の JSON を返す。error は機械が見分けるための短い英字、message は人が読む日本語の説明。

JSON

{
  "error": "string",
  "message": "string"
}

レート制限

短い時間に呼びすぎると、Too Many Requests の状態コードで断る。そのときは応答の Retry-After に書かれた秒数を待ってから呼び直す。

429 · レート制限（Retry-After 付き） · 対象 194 件

OpenAPI 3.1

全 API の定義を OpenAPI の形式で配っている。コードの生成や Postman などへの取り込みに使う。

MCP（AI からつなぐ）

Claude や ChatGPT から BOUNTY を操作したいときは、API を直接呼ばずに MCP でつなぐと、AI が適切な API を選んで下書きを作る。

参加者のアプリが使う API。ログイン、自分のプロフィール、WANTED、マッチ、メッセージ、QR の交換、TRIO、通知など、参加者が画面でする操作はすべてここにある。呼ぶのはログインした本人で、他人の操作を代わりに行う API は無い。

イベントと会場の API。イベントの一覧と参加登録、チケット、会場図、日程とセッション、チェックイン、ブースと出展を扱う。読むだけの入口と、イベントの管理者だけが使える入口が分かれている。

募集（BOSHU）の API。募集を作る・公開する、応募する・取り下げる、審査して結果を知らせる、質問をモジュールで組む、外部のサイトに応募フォームを埋め込む、の一式。

学生団体・学生発ベンチャー・企業の API。団体の登録と審査、メンバーと権限、企業のページと企業へのつながり（企業 QR・問い合わせ）を扱う。

コンテンツ企画の API。タイムテーブルの枠、担当のライン、登壇者、サムネイルを作る。ここで作るのは下書きで、公開は運営が画面で確定する。MCP から AI に組ませるときも同じ API を通る。

外から BOUNTY につなぐための API。MCP の入口、トークンでの読み取り、公開の読み取り（ログインなし）、契約（OpenAPI）、計測を扱う。