本文へ移動

Bounty Developer

PATCH`/api/events/{slug}/manage/admission`

「イベント」の分類の、対象のうち、送った項目だけを直す API。ログインした本人として呼ぶ。

要約: そのイベントの登壇者・進行の入場状況とメモを保存する（変わっていないことを照合）
呼び方と印: ログイン

URL に付ける値（パラメータ）

経路の中の波かっこの部分と、URL の ? の後ろに付ける値。「必須」の印があるものは省けない。

slugpath必須string

送るもの（本文）application/json

送る本文の欄。「必須」の印がある欄は省けない。

expectedActorId必須string(uuid)
people必須array<object>
件数 1–200
key必須string
expectedUpdatedAt必須string(date-time) | null
status任意"unissued" | "issued" | "received"
memo任意string
長さ ≤2000

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

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

eventIdstring(uuid)
eventTitlestring
timezonestring
peoplearray<object>
- keystring
- userIdstring(uuid) | null
- speakerIdsarray<string(uuid)>
- namestring
- rolesarray<"speaker" | "host">
- slotsarray<object>
  - idstring
  - kind"speaker" | "host"
  - titlestring
  - startsAtstring | null
  - endsAtstring | null
- status"unissued" | "issued" | "received"
- memostring
- updatedAtstring | null

失敗したとき（エラー）

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

400入力の誤り（error = invalid_input など）
401未ログイン（unauthorized）/ Bearer が無効（invalid_token。WWW-Authenticate 付き）
403権限が無い
404HTTP 404（x-bounty-error-codes を参照）
409HTTP 409（x-bounty-error-codes を参照）

invalid_origin
event_not_found
not_found
forbidden
manager_reverify_required
invalid_input
actor_changed
duplicate_person
admission_roster_changed
admission_changed

呼び出しの見本

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

curl -X PATCH "https://bounty.spikes.4s.link/api/events/{slug}/manage/admission" \
  -H "Authorization: Bearer $BEARER_AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedActorId": "00000000-0000-4000-8000-000000000000",
    "people": [
      {
        "key": "string",
        "expectedUpdatedAt": "2026-11-01T10:00:00+09:00"
      }
    ]
  }'

PATCH /api/events/{slug}/manage/admission | Bounty Developer