コンテンツにスキップ

出会う人

このエンドポイントは、イベントにほかに誰が参加するかを返します。Crewcade でサインインで得たメンバートークンで使います。トークンに people スコープが必要です。APIキーは使えません。

GET /events/{id}/people

1 つの日程の id を渡します。メンバーは、その日程に確定した申し込みで参加している必要があります。メンバー本人は一覧に入りません。

クエリ型意味
pagenumber読むページ。1 から始まります。初期値は 1 です。
pageSizenumber1 ページの人数。1 から 100 です。初期値は 20 です。

返事には次のフィールドがあります。

フィールド意味
shownクラブが参加者の顔を隠すときは false です。そのとき data は空です。
count参加する人の数。イベントページと同じ数です。
data人の一覧。
paginationページ、ページサイズ、合計、hasNext。

イベントには、参加者の見せ方の設定があります。アプリはこの設定に従います。

  • クラブが顔を見せるときは、それぞれの人に写真があります。
  • クラブが名前だけを見せるときは、全員の avatarUrl が null です。
  • 参加人数がイベントの Show after の人数に届かないときも、shown は false です。クラブは Minimum to Display でこの人数を決めます。count には実際の人数が入ります。
フィールド意味
memberIdクラブでのメンバー id。
name名前(言語コードごと)。nameText は 1 つのテキストです。
handleプロフィールのハンドル。null のこともあります。
avatarUrl写真。null のこともあります。
bio自己紹介(言語コードごと)。bioText は 1 つのテキストです。
socialLinksソーシャルリンク。クラブが一部のサービスを隠すことがあります。
rolesクラブでのメンバーのロール。
propertiesクラブがメンバーに見せるメンバー項目の回答。

メールアドレスは返りません。機微な項目も返りません。ホストだけが見る項目も返りません。

一部の人は data に入りません。それでも count には入ります。

  • プロフィールを非公開にした人。
  • 参加者リストに表示する をオフにした人。プロフィールのプライバシーを見てください。
  • ゲスト。
  • ファミリープロフィール。
ステータスコード意味
401invalid_tokenトークンが正しくありません。
403insufficient_scopeトークンに people スコープがありません。
403not_registeredメンバーは、この日程に確定した申し込みがありません。
404event_not_foundイベントが存在しないか、メンバーが開けません。
404event_is_series繰り返しシリーズの id を送っています。1 つの日程の id を送ってください。
429rate_limitedリクエストが多すぎます。Retry-After ヘッダーの秒数だけ待ってください。