イベント API
APIキーでイベントを読むには、can_view_all_events 権限が必要です。参加者の一覧には can_check_in_attendees も必要です。権限がないと 403 が返ります。
Crewcade でサインインで得たメンバートークンでも、イベントを読めます。追加のスコープは不要です。メンバーには、クラブのページがそのメンバーに見せる内容が表示されます。参加者の一覧は APIキー専用です。
日程、シリーズ、id
Section titled “日程、シリーズ、id”API は日程(occurrence)を返します。日程とは、イベントの 1 回分のことです。
- 1 回だけのイベントには日程が 1 つあります。その
idはイベントのpublicIdです。 - 繰り返しイベントには日程がたくさんあります。日程ごとに 8 文字の
idがあります。すべての日程は同じseriesId(シリーズのpublicId)を持ちます。
id は変わりません。クラブが「この日程以降」を編集しても、同じ日程は同じ id のままです。
下書きは表示されません。中止された日程は status: "cancelled" で表示されます。
イベントの一覧
Section titled “イベントの一覧”GET /events| クエリ | 型 | 意味 |
|---|---|---|
from | string | 期間の始まり。Z かオフセット付きの ISO-8601 時刻。初期値は現在。 |
to | string | 期間の終わり。形式は同じ。初期値は from の 30 日後。最長 92 日。 |
seriesId | string | この繰り返しイベントの日程だけを返します。 |
page | number | 読むページ。1 から始まります。初期値は 1。 |
pageSize | number | 1 ページの日程数。1 から 100。初期値は 20。 |
日程は早い順に返ります。
- これからの日程と開催中の日程は、
fromを空にします。 - 過去の日程は、
toを現在にし、fromをそれより前にします。
curl "https://api.crewcade.com/api/v1/events?from=2026-11-01T00:00:00%2B09:00" \ -H "Authorization: Bearer cck_your_key_here"返事の形は英語版の例と同じです。
期間が逆、92 日より長い、またはタイムゾーンがない場合は 400 が返ります。
1 つの日程を読む
Section titled “1 つの日程を読む”GET /events/{id}日程の id を渡します。返事はイベント 1 件で、一覧の data の項目と同じ形です。
繰り返しシリーズの publicId を渡すと、code: "event_is_series" 付きの 404 が返ります。日程は GET /events?seriesId={id} で一覧できます。
参加者を見る
Section titled “参加者を見る”GET /events/{id}/registrationscan_view_all_events と can_check_in_attendees が必要です。クラブがイベントの参加者ページで見るものと同じ一覧を返します。その日程の確定した登録と当日参加の人です。
| クエリ | 型 | 意味 |
|---|---|---|
page | number | 読むページ。1 から始まります。初期値は 1。 |
pageSize | number | 1 ページの人数。1 から 100。初期値は 20。 |
status は going、checked_in、no_show のどれかです。当日参加の人やメンバーでないゲストは memberId が null です。
イベントの項目
Section titled “イベントの項目”| 項目 | 意味 |
|---|---|
id | 日程の id。ほかの呼び出しにはこれを使います。 |
seriesId | 繰り返しシリーズの publicId。1 回だけのイベントは null。 |
publicId | イベントの publicId。繰り返しの日程ではシリーズのものです。 |
slug | 読みやすいラベル。変わることがあります。 |
urlKey | Crewcade のイベントリンクで使う slug-publicId の形のキー。 |
title | タイトル。言語コードごと。 |
description | 説明。言語コードごと。null のこともあります。 |
start, end | その日のオフセット付きの dateTime と、IANA の timeZone。 |
timing | upcoming、live、past。呼び出したときに決まります。 |
status | scheduled か cancelled。 |
locationType | in_person、online、hybrid、none。 |
venue | name と address。どちらも null のことがあります。 |
hostName | その日の主催者。言語コードごと。null のこともあります。 |
coverImageUrl | フライヤー画像。null のこともあります。 |
capacity | 定員。null は上限なし。 |
spotsRemaining | 残りの席。null は上限なし。 |
properties | クラブがイベント用に決めた項目(クラブ名やレベルなど)。 |
eventUrl | Crewcade のイベントページのアドレス。一覧にも 1 つの日程にもあります。 |
tiers | その日程のチケット。1 つの日程だけにあります。下を見てください。 |
GET /events/{id} は tiers を返します。ティアは、チケットの 1 つの種類です。
| フィールド | 意味 |
|---|---|
id | ティアの id。メンバーを申し込ませるとき tierId として送ります。 |
name | 名前(言語コードごと)。nameText は、求めた言語の 1 つのテキストです。 |
description | 短い説明。null のこともあります。 |
price | amount(通貨の最小単位)と currency。0 は無料です。 |
payMethods | card または in_person。無料のティアでは空です。 |
saleStart、saleEnd | 販売が始まる時刻と終わる時刻。null のこともあります。 |
soldOut | この日程でこのティアの席がなくなると true です。 |
forYou | サインインしたメンバーにとってのこのティアの状態。APIキーでは null です。 |
saleStart と saleEnd は、UTC の ISO 8601 形式の時刻です。Crewcade は、ティアに設定した時刻を、イベントのタイムゾーンで計算します。
forYou には 3 つのフィールドがあります。
availableは、メンバーがいまこのティアを選べるとtrueです。reasonは、ティアが閉じている理由です。tier_disabled、role_restricted、event_full、sold_outのどれかです。開いている有料ティアではpayment_requiredです。開いている無料ティアではnullです。registerViaは、1 回の呼び出しで申し込ませられるときはapiです。メンバーをeventUrlに送るときはevent_pageです。申し込みを見てください。