Bounty Developer
- 543 公開 API
- 34 分類
- 契約 v2.0.0
Bounty Developer は、SPIKES BOUNTY の仕組みを説明する文書のサイトである。BOUNTY は、SPIKES のイベントの参加者が使うアプリと、運営・主催者・団体が使う管理の画面からできていて、どちらも同じ API の上で動いている。
ここでは、機能ごとの仕組み、運営の作業の手順、公開の API、4S などの外部のサービスとのつながり、認証とトークン、AI からつなぐ MCP を説明している。読む人によって入口が違うので、下の「読む人ごとの入口」から始めるとよい。
読む人ごとの入口
SPIKES の運営メンバー
タイムテーブルを組む、募集を出して審査する、設問を直す、団体を審査する、といった作業の手順は作業ガイドにまとめている。やりたいことから引けば、開く画面と順番と、誰がやれるかが分かる。その機能がどう動くかを詳しく知りたいときは機能の頁を読む。
外部の開発者
BOUNTY の画面が使っているのと同じ HTTP の API を、分類ごとに説明している。まず API の頁の「はじめに」でベース URL・認証・エラーの形を読み、次に認証とトークンの頁で呼び方を選ぶ。4S などの外部のサービスとどうつながっているかは、4S と外部連携の頁にある。BOUNTY にモジュールを足して広げたいときは、拡張のしかたを読む。
AI で操作したい人
Claude や ChatGPT から BOUNTY を操作したいときは、API を直接呼ばずに MCP でつなぐ。URL を貼ってログインするだけで、AI が募集・プログラム・出展・会場図などの下書きを作る。公開は人が画面で行うので、作業ガイドの各作業の手順と合わせて読む。
全体の図
下の図は、誰が BOUNTY を呼び、BOUNTY がどこを呼ぶかを一枚にしたものである。
左（狭い画面では上）が BOUNTY を使う側で、参加者のアプリ・運営の画面・募集や団体の外部の連携・AI のクライアントである。中央は BOUNTY の公開の API を区分ごとに数えたもので、右（狭い画面では下）は BOUNTY が呼ぶ外部のサービスとその呼び出しの数である。区分の中身は API の頁、外部のサービスは 4S と外部連携の頁で読める。
すべての文書
- 機能参加者・イベント・募集・団体の機能ごとに、何ができるか、仕組み、流れの図、実際の画面、関係する API を説明している。
- 作業ガイド運営メンバー向け。タイムテーブルの公開、募集の審査、設問の修正、団体の審査、会場図、AI への依頼、フォームの埋め込み、外部サイトへの会場マップとタイムテーブルの手順を、やりたいことから引ける。
- 拡張のしかたBOUNTY の機能をモジュールとして足し、広げるための手引き。
- API公開の API を分類ごとに並べている。各 API の送るもの・返るもの・例と、OpenAPI の定義を配っている。543 件
- 4S と外部連携BOUNTY が呼ぶ外部のサービス（4S・SPIKES の兄弟サービス・通知とメール・Google など）と、それぞれで何をやり取りしているか。
- 認証とトークンログイン・アプリのトークン・API トークン・OAuth の違いと、トークンに付ける範囲（scope）の説明。
- MCPClaude・ChatGPT・Claude Code・Codex を BOUNTY につなぐ手順と、AI に頼める下書きの一覧。