出会う人
このエンドポイントは、イベントにほかに誰が参加するかを返します。Crewcade でサインインで得たメンバートークンで使います。トークンに people スコープが必要です。APIキーは使えません。
参加する人を一覧する
Section titled “参加する人を一覧する”GET /events/{id}/people1 つの日程の id を渡します。メンバーは、その日程に確定した申し込みで参加している必要があります。メンバー本人は一覧に入りません。
| クエリ | 型 | 意味 |
|---|---|---|
page | number | 読むページ。1 から始まります。初期値は 1 です。 |
pageSize | number | 1 ページの人数。1 から 100 です。初期値は 20 です。 |
返事には次のフィールドがあります。
| フィールド | 意味 |
|---|---|
shown | クラブが参加者の顔を隠すときは false です。そのとき data は空です。 |
count | 参加する人の数。イベントページと同じ数です。 |
data | 人の一覧。 |
pagination | ページ、ページサイズ、合計、hasNext。 |
イベントには、参加者の見せ方の設定があります。アプリはこの設定に従います。
- クラブが顔を見せるときは、それぞれの人に写真があります。
- クラブが名前だけを見せるときは、全員の
avatarUrlがnullです。 - 参加人数がイベントの Show after の人数に届かないときも、
shownはfalseです。クラブは Minimum to Display でこの人数を決めます。countには実際の人数が入ります。
1 人ごとの内容
Section titled “1 人ごとの内容”| フィールド | 意味 |
|---|---|
memberId | クラブでのメンバー id。 |
name | 名前(言語コードごと)。nameText は 1 つのテキストです。 |
handle | プロフィールのハンドル。null のこともあります。 |
avatarUrl | 写真。null のこともあります。 |
bio | 自己紹介(言語コードごと)。bioText は 1 つのテキストです。 |
socialLinks | ソーシャルリンク。クラブが一部のサービスを隠すことがあります。 |
roles | クラブでのメンバーのロール。 |
properties | クラブがメンバーに見せるメンバー項目の回答。 |
メールアドレスは返りません。機微な項目も返りません。ホストだけが見る項目も返りません。
一覧に入らない人
Section titled “一覧に入らない人”一部の人は data に入りません。それでも count には入ります。
- プロフィールを非公開にした人。
- 参加者リストに表示する をオフにした人。プロフィールのプライバシーを見てください。
- ゲスト。
- ファミリープロフィール。
| ステータス | コード | 意味 |
|---|---|---|
| 401 | invalid_token | トークンが正しくありません。 |
| 403 | insufficient_scope | トークンに people スコープがありません。 |
| 403 | not_registered | メンバーは、この日程に確定した申し込みがありません。 |
| 404 | event_not_found | イベントが存在しないか、メンバーが開けません。 |
| 404 | event_is_series | 繰り返しシリーズの id を送っています。1 つの日程の id を送ってください。 |
| 429 | rate_limited | リクエストが多すぎます。Retry-After ヘッダーの秒数だけ待ってください。 |