API リファレンス
イベント
- GET
/eventsイベント一覧・検索イベントを多彩なフィルタで検索・一覧取得します。公開レスポンスでは startTime / endTime / onlineUrl は含まれず、開催日時は schedules を参照します。groupByDate=true で開催日単位のグループ形状になります。 - GET
/events/:idイベント詳細イベントの詳細を取得します。パスには ID または slug を指定できます。セッション・登壇者・ステージ・チケット・主催者などを含みます。 - GET
/events/geojsonイベントの地図ピン座標を持つ公開イベントを GeoJSON FeatureCollection で返します。ページングせず、bbox で表示範囲に絞り込みます。フィルタは GET /events と同じ意味です。 - GET
/events/counts-by-dateイベントがある日付の一覧指定期間のうちイベントが存在する日付だけを返します。カレンダーの日付マーク用で、一覧 API より軽量です。 - GET
/events/my-entries自分の参加イベント認証中ユーザーが参加登録したイベントを、参加登録日時の降順で取得します。 - GET
/events/:eventId/is-staffイベントスタッフか判定認証中ユーザーがそのイベントのスタッフかどうかを真偽値で返します。ロールと権限の一覧が必要な場合は GET /manage/events/:eventId/acl を使ってください。 - GET
/events/:eventId/chat-roomイベントのチャットルームイベントの公開チャットルームを取得します(存在しない場合は作成されます)。チャットが有効なイベントの参加者のみアクセスできます。 - GET
/events/:eventId/participants参加者一覧イベントの参加者(参加確定・チェックイン済みかつミーティング受付中)を取得します。参加者リストの公開設定に従いアクセス制御されます。 - GET
/events/:eventId/participants/:userId/questions参加者のアンケート回答イベント参加者 1 人分のアンケート設問と回答を返します。公開されている設問だけが対象です。ミーティングの相手を選ぶときのプロフィール表示に使います。 - PATCH
/events/:eventId/entries/:entryId/meeting-preferenceミーティングの受付設定自分の参加登録について、ミーティングリクエストを受け付けるかどうかを切り替えます。false にすると参加者検索に出なくなり、新しいリクエストも受け取らなくなります(既存のミーティングはそのまま残ります)。 - GET
/events/:eventId/stagesステージ一覧イベントのステージ(会場)一覧を返します。 - GET
/events/:eventId/sessionsセッション一覧イベントの公開セッション(タイムテーブル)一覧を返します。 - GET
/events/:eventId/sessions/:idセッション詳細セッション 1 件の詳細を返します。 - GET
/events/:eventId/speakers登壇者一覧イベントの公開登壇者一覧を返します。 - GET
/events/:eventId/speakers/:entryId登壇者詳細登壇者 1 件の詳細を返します。担当セッションを含みます。 - GET
/events/:eventId/announcementsイベントのお知らせ一覧イベントのお知らせ一覧を返します。参加者のみアクセスできます。 - GET
/events/:eventId/announcements/:idイベントのお知らせ詳細イベントのお知らせ 1 件を返します。参加者のみアクセスできます。 - GET
/events/:eventId/ticketsチケット一覧イベントの販売中チケット種別の一覧を返します。 - GET
/events/:eventId/tickets/:ticketIdチケット詳細チケット種別 1 件の詳細を返します。 - GET
/events/:eventId/questionsアンケート設問一覧参加登録時に回答するアンケートの設問一覧を返します。 - GET
/events/:eventId/my-questions自分のアンケート回答認証中ユーザー自身が回答したアンケートの設問と回答を返します。 - GET
/events/:eventId/meeting-spotsミーティング場所一覧イベント運営者が設定したミーティング場所の一覧を返します。 - GET
/events/:eventId/referral-rankingリファラル影響力ランキングイベントの招待チェーンに基づく影響力ランキング(上位 100 件)を取得します。 - GET
/events/:eventId/entries自分の参加登録状態認証中ユーザーの、指定イベントに対する参加登録(キャンセル以外)を取得します。 - DELETE
/events/:eventId/entries/:entryId参加登録をキャンセル自分の参加登録をキャンセルします。既にキャンセル済み・チェックイン済みの参加登録はキャンセルできません。有料チケットはイベントの返金ポリシーに従って自動返金されます。 - POST
/events/:eventId/entries/:entryId/invitation-code招待コードを発行認証中ユーザー自身の参加登録から、リファラル招待コードを発行します。1 つの参加登録につきコードは 1 つで、発行済みならそのコードを返します(チケットの招待設定が変わっていれば、コードの招待先・利用上限を現在の設定に合わせてから返します)。リクエストボディは不要です。 - GET
/events/:eventId/entries/:entryId/referral-ancestorsリファラル祖先(招待元チェーン)指定参加登録から招待元を上方向に辿り、対象に近い順で返します。呼び出しユーザーが当該イベントの確定参加者(CONFIRMED / CHECKED_IN)でない場合は 403 です。 - GET
/events/:eventId/entries/:entryId/referral-descendantsリファラル子孫(招待ツリー)指定参加登録を根として招待ツリーを下方向に展開します。各ノードの直接の子は childrenLimit + cursor でページングされ、子の総数(CONFIRMED / CHECKED_IN のみ)も返します。呼び出しユーザーが確定参加者でない場合は 403 です。 - POST
/events/:eventId/registerイベントに参加登録イベントに参加登録します。無料チケットは即座に UNUSED(承認制の場合は PENDING)になります。有料チケットは先に決済リンクまたは事前決済チェックアウトで支払いを完了してください。 - POST
/events/:eventId/tickets/:ticketId/payment-link決済リンクを作成有料チケットの Stripe 決済リンクを作成します。返された url にユーザーを遷移させ、決済完了後に Webhook 経由で参加登録が確定します。successUrl / cancelUrl で決済後の戻り先を自サイトに指定できます。 - POST
/events/:eventId/tickets/:ticketId/prepaid-checkout事前決済チェックアウトを作成アンケート回答を先に保存したうえで Stripe Checkout を作成します。在庫は一定時間だけ確保され、期限内に決済されなければ解放されます。 - POST
/events/:eventId/tickets/:ticketId/payment-intent決済シート用の PaymentIntent を作成モバイルアプリの決済シート(Stripe PaymentSheet)で支払うための PaymentIntent を作成します。事前決済チェックアウトと同じくアンケート回答・プロフィール項目を先に保存し、在庫を一定時間だけ確保します。参加登録は決済完了の webhook で作成されます。 - PUT
/events/:eventId/entries/:entryId/transferチケットを譲渡複数枚購入して余っている未使用(UNUSED)のチケットを、ほかのユーザーへ譲渡します。譲渡できるのは購入者本人で、譲渡不可設定のチケットは対象外です。 - POST
/questions/:questionId/answerアンケートに回答参加登録後にアンケートへ回答(または回答を更新)します。既に回答済みの場合は上書きされます。 - POST
/questions/:questionId/answer-imageアンケート回答画像をアップロード画像回答型の設問に添付する画像をアップロードし、保存された URL を返します。返った URL を POST /questions/:questionId/answer の answer に指定します。 - GET
/events/:eventId/meetingsミーティング一覧自分が関係するミーティング(送信・受信の両方)の一覧を返します。他の参加者同士のミーティングは含まれません。 - POST
/events/:eventId/meetingsミーティングをリクエストイベントの他の参加者にミーティングをリクエストします。相手とのダイレクトチャットルームが無ければ作成し、最初のメッセージとして本文を投稿します。作成直後のステータスは REQUESTED で、場所と時間は未定です。 - GET
/chat-rooms/:chatRoomId/meetingsチャットルームのミーティングチャットルームに紐づくミーティングを返します。チャット画面にミーティングの操作 UI や一覧を出すために使います。ルームのメンバーでない場合は 403 を返します。 - PUT
/meetings/:meetingId/statusミーティングのステータスを変更承認・拒否・キャンセル・再許可・キャンセル取り消しをまとめて扱います。遷移できるかどうかは現在のステータスと自分の立場で決まります。 - PUT
/meetings/:meetingId/confirmミーティングの場所と時間を設定承認済み(CONFIRMED)のミーティングに場所と時間を設定します。設定済みのミーティングに対して呼ぶと変更になります。 - GET
/meetings/:meetingId/meeting-spots選択できるミーティング場所そのミーティングで選択できる場所の一覧を返します。イベント全体の一覧(GET /events/:eventId/meeting-spots)と違い、参加者のチケット種別で選べる場所だけに絞られています。 - GET
/meetings/:meetingId/available-slots空き時間枠指定した場所・日付でミーティングを設定できる時間枠を返します。枠はイベントの meetingSlotDuration 単位で刻まれます。