本文へ移動
Bounty Developer

GET/api/mcp/whoami

「MCP」の分類の、情報を読み出す API。ログインした本人として呼ぶ。

要約

MCP 接続の確認: 接続している本人の表示名・運営権限・トークンの scope と期限（cookie のログインは token = null）・対象イベント・4S 連携と規約同意の状態・領域ごとの capabilities（can と、できない理由 1 つ。upload は予約できる purposes）・本人が管理する manages（イベント・会社・団体・学生発ベンチャー・BOSHU の主体）。can は各 API と同じ判定で、公開は常に draft_only（どの scope の API トークンでも・ログインでも）

呼び方と印

ログイン・レート制限

短い時間に呼びすぎると断られる API（レート制限）。断られたら Retry-After の秒数を待って呼び直す。

返るもの（応答）200 · application/json

成功したときに返る形。入れ子の欄は、その行を押すと開く・閉じる。「任意」の印がある欄は返らないことがある。

  • displayNamestring
  • staffRole"none" | "moderator" | "admin"
  • tokenobject | null
    • scopesarray<enum(11)>
    • expiresAtstring(date-time) | null
  • eventobject | null
    • idstring(uuid)
    • namestring
  • foursLinkedboolean
  • consent"current" | "required"
  • capabilitiesarray<object>
    • domainenum(12)"upload" "import" "content" "planning" "exhibit" "company" "company_invite" "boshu" "orgs" "passes" "intake_discord" "moderation"
    • scopeenum(11) | null"boshu" "orgs" "import" "content" "exhibit" "company" "passes" "intake_discord" "publish" "moderation" "tickets"
    • canboolean
    • reason任意enum(6)"scope_not_granted" "staff_only" "fours_link_required" "consent_required" "manager_reverify_required" "no_managed_entity"
    • managesarray<object>件数 ≤64
      • kindenum(6)"person" "platform" "event" "guild" "venture" "company"
      • idstring(uuid) | null
      • namestring長さ ≤200
    • purposes任意array<enum(6)>
  • managesobject
    • eventsarray<object>件数 ≤21
      • idstring(uuid)
      • namestring長さ ≤200
      • isPrimaryboolean
    • companiesarray<object>件数 ≤20
      • idstring(uuid)
      • namestring長さ ≤200
    • guildsarray<object>件数 ≤20
      • idstring(uuid)
      • namestring長さ ≤200
    • venturesarray<object>件数 ≤20
      • idstring(uuid)
      • namestring長さ ≤200
    • boshuSubjectsarray<object>件数 ≤64
      • kindenum(6)"person" "platform" "event" "guild" "venture" "company"
      • idstring(uuid) | null
      • namestring長さ ≤200
  • publication"draft_only"

失敗したとき（エラー）

失敗したときの状態コードと、その意味。本文の error の値で、プログラムが失敗の種類を見分けられる。

  • 400入力の誤り（error = invalid_input など）
  • 401未ログイン（unauthorized）/ Bearer が無効（invalid_token。WWW-Authenticate 付き）
  • 403HTTP 403（x-bounty-error-codes を参照）
  • 429レート制限（Retry-After 付き）
  • invalid_token
  • unauthorized
  • oauth_token_mcp_only

呼び出しの見本

そのまま試せる呼び出しの例。curl と fetch をタブで切り替える。ID やトークンは自分の値に置き換える。

curl "https://bounty.spikes.4s.link/api/mcp/whoami" \
  -H "Authorization: Bearer $BEARER_AUTH"
GET /api/mcp/whoami | Bounty Developer