イベント
イベントの API。イベントの一覧とページ、アプリでの参加表明、主催者のフォロー、壁打ち（ミーティングのライン）を扱う。イベントを管理する人向けには、機能の ON / OFF、チケットの系統と段、設問、プロモーションコード、お知らせ、協賛、スタッフ、入場状況の入口がある。
この分類のあらまし
- 誰が呼べるか
一覧や会場案内図など一部はログインなしで読める。参加者の操作はログインした本人が呼ぶ。経路に manage が入る入口は、そのイベントを管理する人が呼ぶ。
ログイン 79 件・認証なし 4 件・トークン 1 件
- 件数と印
この分類の API は 84 件・レート制限 18 件
短い時間に呼びすぎると断られる API（レート制限）。断られたら Retry-After の秒数を待って呼び直す。
- 契約での分類の説明
SPIKES のイベント一覧・イベントのページ（複数イベント・機能の ON / OFF・参加者）
よく使う順番
上から順に呼ぶことが多い組み合わせ。行を押すと、その API の詳細が右に開く（スマホは下から）。
すべての API84 件
この分類の API をすべて並べている。行を押すと、頁を移らずにその API の詳細が右に開き、送るもの・返るもの・呼び出しの見本が読める。閉じると一覧の同じ位置に戻る。
行の左の札は HTTP のメソッド。GET は情報の取得、POST は作成や操作の実行、PUT と PATCH は更新、DELETE は削除を表す。
- ほかのイベント（主以外）の4Sチケットの登録リンク。そのイベントの4SイベントIDだけを読み、questions指定時のみ該当チケットの質問を確認（そのイベントの管理者。tickets scope の PAT でも読める。主のイベントは /api/admin/tickets で、ここは404）GET取得
/api/events/{slug}/manage/ticket-linksトークン（scope tickets） - SPIKES のイベント（参加中 / これから / これまで）と、押したときの行き先（このアプリ・切り替え・4S の外部ページ）GET取得
/api/events/directory認証なし - 本人の4Sイベント作成結果。requestId指定時は同じ送信の結果だけを確認し、POSTを再送しないGET取得
/api/events/createログイン・レート制限 - 本人の4S OAuthでイベント下書きを一度作成。同じrequestIdは結果を返し、結果不明の再送・別キー作成を止めるPOST作成・操作
/api/events/createログイン・レート制限 - イベントの公開主催者をBOUNTY内でフォロー。本人の状態と人数のみ返すPOST作成・操作
/api/events/{slug}/organizers/followログイン・レート制限 - 本人の主催者フォローを解除（冪等）DELETE削除
/api/events/{slug}/organizers/followログイン・レート制限 - アプリ内のイベント一覧（開催中 → これから。終わったもの・隠したものは出さない）。機能の ON / OFF・自分が参加者か・管理できるかGET取得
/api/eventsログイン - イベントのページ（概要・日程・会場・説明・4S のタイムテーブル・受付中の募集・フォロー・参加 / 管理の印。管理者には機能の一覧）GET取得
/api/events/{slug}ログイン - 機能の ON / OFF を変える（そのイベントの管理者・運営の管理者。監査ログ event.features）。チケットと設問の組み立て（ticket_modules）は売れる段が無ければ 409 ticket_modules_not_ready（acknowledge に入れて送り直すと ON）PATCH一部を更新
/api/events/{slug}/featuresログイン - 選択イベントの WANTED の束（/api/hunt/deck と同じ推薦の並びをそのイベントの参加者に絞る。wanted ON・本人の現在の参加資格を確認）。操作は同イベントの swipe を使用GET取得
/api/events/{slug}/participantsログイン - 選択イベントの開催規模と機能を変更（cookie・現在の管理権限・設定版を照合）。ticket_modules を売れる段なしで ON にすると 409 ticket_modules_not_ready（features.acknowledge で確認つき ON。/features と同じ確かめ）PATCH一部を更新
/api/events/{slug}/settingsログイン - 選択イベントに会いたい・スキップを記録。双方の現在の参加資格と本人・設定版を照合し、同イベントの相互操作だけでマッチPOST作成・操作
/api/events/{slug}/swipeログイン・レート制限 - 選択イベントの確認済みのつながりから共通DMを開く。既存DMの権限・期限を変更せず、URLだけでイベント由来を追加しないPOST作成・操作
/api/events/{slug}/messages/dmログイン・レート制限 - アプリでの参加表明（機能 self_join が ON のイベントだけ。既定 OFF。4S の参加登録が正本）POST作成・操作
/api/events/{slug}/joinログイン・レート制限 - アプリでの参加表明を取り消す（本人が表明した分だけ）DELETE削除
/api/events/{slug}/joinログイン・レート制限 - 本人の参加中のイベント（4S GET /events/my-entries）と管理するイベント（各イベントの自分のスタッフの役割）を 4S から読み直すPOST作成・操作
/api/me/events/refreshログイン・レート制限 - 主以外のイベントのパートナー一覧へ追加・解除する（そのイベントの管理者だけ。本文に eventId は持たない。原票・申請・団体・出展は保持）POST作成・操作
/api/events/{slug}/manage/partners/rosterログイン（cookie）・レート制限 - 主以外のイベントのパートナーへ追加する既存団体・公開している企業を検索する（読取り専用・最大60件）POST作成・操作
/api/events/{slug}/manage/partners/roster/searchログイン（cookie）・レート制限 - 主以外のイベントのパートナーの段の設定・件数・手動付与/取消を 1 件保存する（理由必須・監査）POST作成・操作
/api/events/{slug}/manage/partners/standingログイン（cookie）・レート制限 - 壁打ちの公開席・担当時間割と集計（参加者情報を含まない）GET取得
/api/wall-consult/{eventId}/schedule認証なし - 本人の壁打ち受付・枠に結んだミーティング・通常チャット文脈GET取得
/api/wall-consult/{eventId}/meログイン - 確認済み担当者自身の担当時間・私的な列・気になるの件数・枠に結んだミーティングGET取得
/api/wall-consult/{eventId}/hostログイン - 気になる（公開後〜枠の終了）・当日の受付/列/担当者操作・気になるを送った人への5〜15分のミーティング提案（QR交換/得点は変更しない）POST作成・操作
/api/wall-consult/{eventId}/actionログイン・レート制限 - チケットの系統と段の一覧（4S との結びつき・同期の状態つき）GET取得
/api/events/{slug}/manage/ticketsログイン - チケットの系統を作るPOST作成・操作
/api/events/{slug}/manage/ticketsログイン - チケットの系統を直す（4S に作った段がある系統は支払いの種類を変えられない）PUT更新
/api/events/{slug}/manage/tickets/{familyId}ログイン - チケットの系統を保管する（4S のチケットは消さない）DELETE削除
/api/events/{slug}/manage/tickets/{familyId}ログイン - チケットの系統を段ごと複製する（4S の結びつきは写さない）POST作成・操作
/api/events/{slug}/manage/tickets/{familyId}/duplicateログイン - 段（価格の段・XX限定）を足す（未結合で保存し、4S への作成を予約する）POST作成・操作
/api/events/{slug}/manage/tickets/{familyId}/tiersログイン - 段を直す（4S に作った段の価格・種類は変えられない）PUT更新
/api/events/{slug}/manage/tickets/{familyId}/tiers/{tierId}ログイン - 段を外す（4S に一度も触れていない段だけ消す。ほかは保管して 4S を DRAFT へ寄せる。4S のチケットは消さない）DELETE削除
/api/events/{slug}/manage/tickets/{familyId}/tiers/{tierId}ログイン - 基本の段からバリアントをまとめて作る（札 | 枚数 | 価格 の行。1 つのトランザクションで checkFamilyTiers を通す。4S への作成は段ごとに予約）POST作成・操作
/api/events/{slug}/manage/tickets/{familyId}/tiers/{tierId}/variantsログイン - 段をまとめて直す（枚数・期間・止める / 戻す・公開・価格。4S に作った段の価格は直さず refused に理由を返す）PATCH一部を更新
/api/events/{slug}/manage/tickets/{familyId}/tiersログイン - 団体専用のチケットを作る（基本の段から、札 = 団体の名前・配る団体 = その団体のリンクだけのバリアント）POST作成・操作
/api/events/{slug}/manage/tickets/{familyId}/org-ticketログイン - 4S のチケットをまとめて取り込む案（説明の本文と設問で系統にまとめ、基本と違う項目に印。読むだけ）GET取得
/api/events/{slug}/manage/ticket-sync/importログイン - 選んだ系統を取り込む（サーバが 4S を読み直して案を作り直す。系統 + 結んだ段 + バリアントを 1 つのトランザクションで。4S へは書かない）POST作成・操作
/api/events/{slug}/manage/ticket-sync/importログイン - 系統を別のイベントへ写す（同じ形。4S の結びつき・配る人は写さない。設問は写し先に下書きで写す。写し元と写し先の両方の管理者）POST作成・操作
/api/events/{slug}/manage/tickets/{familyId}/copyログイン - 系統を写せる先（自分が管理者で機能が ON のほかのイベント）GET取得
/api/events/{slug}/manage/ticket-copy-targetsログイン - 配る人・団体の候補（?q= 名前。承認済みの団体と公開の人）GET取得
/api/events/{slug}/manage/ticket-distributorsログイン - 段の申し込みの資格を変える（link = リンクを持っていれば申し込める・既定 / org_members = 配る団体の在籍者だけ。配る団体の無い段は 422。4S へは送らない）PUT更新
/api/events/{slug}/manage/tickets/{familyId}/tiers/{tierId}/eligibilityログイン - 系統の段の並びPUT更新
/api/events/{slug}/manage/tickets/{familyId}/tiers/orderログイン - チケットと設問の組み立ての機能の状態と準備（売れる段の数。機能が OFF でも読める。ON にする前の確認と画面の印に使う）GET取得
/api/events/{slug}/manage/ticket-readinessログイン - チケットの設問の一覧（いまの公開版つき）GET取得
/api/events/{slug}/manage/questionnairesログイン - チケットの設問を作る（空の下書き）POST作成・操作
/api/events/{slug}/manage/questionnairesログイン - チケットの設問の下書きといまの公開版GET取得
/api/events/{slug}/manage/questionnaires/{questionnaireId}ログイン - チケットの設問の下書きを丸ごと保存する（ページ → モジュール → 質問。公開と同じ決まりで全体を確かめる。公開したページの行き先は変えられない）PUT更新
/api/events/{slug}/manage/questionnaires/{questionnaireId}ログイン - チケットの設問を保管する（公開版と回答は残す。使っている系統があれば 409）DELETE削除
/api/events/{slug}/manage/questionnaires/{questionnaireId}ログイン - 下書きからページを外す（公開版は固定のまま）DELETE削除
/api/events/{slug}/manage/questionnaires/{questionnaireId}/pages/{pageId}ログイン - 下書きのページからモジュールを外す（共通モジュールそのものは残る。公開版は固定のまま）DELETE削除
/api/events/{slug}/manage/questionnaires/{questionnaireId}/pages/{pageId}/modules/{refId}ログイン - チケットの設問を公開する（共通モジュールを写して版を固定する。4S 共通のページは 4S の設問へ合わせる）POST作成・操作
/api/events/{slug}/manage/questionnaires/{questionnaireId}/publishログイン - チケットの設問の回答を CSV で書き出す（1 人 1 行・ページ → モジュール → 質問の列。個人情報の印は運営の管理者とそのイベントの管理者だけ・4S / GEEK 共通のページの回答は 4S にあり含めない・監査ログ。機能が OFF でも読める）GET取得
/api/events/{slug}/manage/ticket-answers/exportログイン - 共通モジュールの棚（このイベントの分と全イベント共通の分）GET取得
/api/events/{slug}/manage/form-modulesログイン - 共通モジュールを作る（全イベント共通は運営の管理者だけ。行き先に募集 boshu_call を含められ、募集だけならチケットの機能が OFF でも作れる）POST作成・操作
/api/events/{slug}/manage/form-modulesログイン - 共通モジュールを直す（revision が 1 増える。公開済みの設問は変わらない）PUT更新
/api/events/{slug}/manage/form-modules/{moduleId}ログイン - 共通モジュールを保管する（公開版は変わらない。下書きからは参照を外す。全イベント共通は運営の管理者だけ）DELETE削除
/api/events/{slug}/manage/form-modules/{moduleId}ログイン - 4S への書き込みの許可の状態（引き受けた人・期限・期限の 7 日前からの知らせ・書けない理由。イベントの管理者）GET取得
/api/events/{slug}/manage/ticket-sync/grantログイン - 自分の 4S の許可でこのイベントの 4S への書き込みを引き受ける（4S でチケットと設問を書ける権限を確かめる。期限は 60 日。監査ログ）POST作成・操作
/api/events/{slug}/manage/ticket-sync/grantログイン - 4S への書き込みの許可を外す（以後 4S へは何も送らない。監査ログ）DELETE削除
/api/events/{slug}/manage/ticket-sync/grantログイン - 4S にある非公開を含むチケット（取り込みの候補。結んだものは段の ID）。本人の 4S の許可で読むだけGET取得
/api/events/{slug}/manage/ticket-sync/adoptableログイン - 既にある 4S のチケットを系統の段として取り込む（作り直さない。価格・支払いの種類（系統と違えば段に持つ）・枚数・承認制は 4S の値。4S へは書かない。監査ログ）POST作成・操作
/api/events/{slug}/manage/ticket-sync/adoptログイン - 4S にある設問と 4S 共通のページの質問（結びつきつき）。本人の 4S の許可で読むだけGET取得
/api/events/{slug}/manage/ticket-sync/questionsログイン - 4S 共通の質問を既にある 4S の設問へ結ぶ・外す（作り直さない。既に買った人の回答は 4S に残る。4S へは書かない。監査ログ）PUT更新
/api/events/{slug}/manage/ticket-sync/questionsログイン - 結果の分からない 4S への作成の候補（サーバの読み戻しと同じ条件。本人の 4S の許可で読むだけ）。結果の分からない作成が無ければ空GET取得
/api/events/{slug}/manage/ticket-sync/candidatesログイン - 1 段を今すぐ 4S と合わせる（作る・直す・結果の分からない作成を読み戻す。foursTicketId で候補から選ぶ）。書けないときは skipped と理由POST作成・操作
/api/events/{slug}/manage/ticket-sync/syncログイン - プロモーションコードの一覧と使った人数（主のイベントだけ。ほかのイベントは 404）GET取得
/api/events/{slug}/manage/promo-codesログイン - プロモーションコードを作る（コード・札・対象の 4S のチケットの uniqueId・上限・締切。基準のチケットから専用の4Sチケットを作り同期する）POST作成・操作
/api/events/{slug}/manage/promo-codesログイン - 決まらない申込（予約から一定時間を過ぎても 4S の結果が分からない registration_pending）。時間では枠を返さないGET取得
/api/events/{slug}/manage/promo-codes/intentsログイン - 決まらない申込を決める: recheck = 4S を運営の権限で確かめ直す（受け付けられていれば登録済み、エントリが無ければ枠を戻す）、release = 運営の判断で枠を戻す。監査に残すPOST作成・操作
/api/events/{slug}/manage/promo-codes/intents/{userId}ログイン - 札・上限・締切を直す・止める・再開する（コードと対象のチケットは変えない）PATCH一部を更新
/api/events/{slug}/manage/promo-codes/{codeId}ログイン - 本人が画像を作れる active な公開済みテンプレートのイベントGET取得
/api/participation-visual/activeログイン - 公開済みの会場案内図（SVG）GET取得
/api/events/{slug}/venue-guide認証なし - ミーティングのライン（壁打ち）の時間割と空き枠の数（ログイン不要）GET取得
/api/wall-consult/{eventId}/line認証なし - そのイベントの参加者へお知らせを送る（そのイベントの管理者だけ。宛先はそのイベントだけ）POST作成・操作
/api/events/{slug}/manage/announceログイン・レート制限 - そのイベントの参加者の人数（送る前の確認。数だけ）GET取得
/api/events/{slug}/manage/announce/countログイン - そのイベントの 4S のスタッフの名簿と候補（そのイベントの管理者だけ）GET取得
/api/events/{slug}/manage/event-staffログイン - そのイベントの 4S のスタッフを足す・役割を変える・外す（手元の役割は写さない）POST作成・操作
/api/events/{slug}/manage/event-staffログイン - そのイベントの協賛を足す（そのイベントの管理者だけ。公開している企業だけ・本文に eventId は持たない）POST作成・操作
/api/events/{slug}/manage/sponsorsログイン（cookie）・レート制限 - そのイベントの協賛を直す（行のイベントが slug のイベントのときだけ）PATCH一部を更新
/api/events/{slug}/manage/sponsors/{id}ログイン（cookie）・レート制限 - そのイベントの協賛を消す（行のイベントが slug のイベントのときだけ）DELETE削除
/api/events/{slug}/manage/sponsors/{id}ログイン（cookie）・レート制限 - そのイベントの協賛の区分を足す・名前を変える（本文に eventId は持たない）POST作成・操作
/api/events/{slug}/manage/sponsor-tiersログイン（cookie）・レート制限 - そのイベントの登壇者・進行の入場状況の一覧（そのイベントの管理者だけ）GET取得
/api/events/{slug}/manage/admissionログイン - そのイベントの登壇者・進行の入場状況とメモを保存する（変わっていないことを照合）PATCH一部を更新
/api/events/{slug}/manage/admissionログイン - そのイベントの登壇者・進行の入場状況を CSV で書き出すGET取得
/api/events/{slug}/manage/admission/exportログイン - 団体の審査（主以外のイベント）: そのイベントへの参加の申込だけを、既存の入口で承認・見送り・差し戻し。団体の登録（SPIKES 全体）は書かない（審査待ちは 409 org_registration_pending、見送りは見送りだけ。そのイベントの管理者・そのイベントに申し込んだ団体だけ）POST作成・操作
/api/events/{slug}/manage/org-review/{kind}/{id}ログイン