コンテンツにスキップ

自分とクラブ

このエンドポイントで、アプリはメンバーが誰か、どのクラブと話しているかを知ります。すべての /v1 ルートで言語がどう働くかも説明します。

サインイン中のメンバーを読む

Section titled “サインイン中のメンバーを読む”
GET /me

このエンドポイントにはメンバートークンが必要です。メンバートークンはCrewcade でサインインで得ます。APIキー では使えません。

Terminal window
curl https://api.crewcade.com/api/v1/me \
-H "Authorization: Bearer ccm_your_member_token"

返事には、メンバーが許可した項目だけが入ります。

スコープ返事の項目
profileid、name、nameText、photoUrl
emailemail、emailVerified
{
"id": "mem_123",
"name": { "en": "Alex Kim", "ja": "アレックス・キム" },
"nameText": "アレックス・キム",
"photoUrl": null,
"email": "[email protected]",
"emailVerified": true
}
  • id はメンバーIDです。IDトークンの sub と同じ値です。
  • メンバーに実際のメールアドレスがないとき、email は null です。
  • profile スコープがないと、名前と写真の項目は入りません。
  • email スコープがないと、メールの項目は入りません。
GET /workspace

このエンドポイントは、APIキー でもメンバートークンでも使えます。返事はどちらも同じです。

Terminal window
curl https://api.crewcade.com/api/v1/workspace \
-H "Authorization: Bearer cck_your_key_here"
{
"id": "k3m9x2pq4r7t",
"name": "Sunrise Running Club",
"defaultLocale": "en",
"enabledLocales": ["en", "ja"],
"timeZone": "Asia/Tokyo"
}
項目意味
idクラブのIDです。
nameクラブの名前です。
defaultLocaleクラブの標準の言語です。
enabledLocalesクラブが使う言語です。
timeZoneクラブのタイムゾーンです。IANA 形式の名前です。

すべての /v1 ルートで言語を選べます。選び方は2つです。

  • リクエストに ?locale=ja を付けます。
  • Accept-Language ヘッダーを送ります。例は ja-JP,ja;q=0.9 です。

両方送った場合は locale が優先されます。未知の locale は 400 エラーになります。

翻訳のあるテキスト項目は、今までのマップのままです。たとえば name は { "en": "Alex Kim", "ja": "..." } のままです。そのうえで、nameText のように Text で終わる項目が加わります。Text の項目は、選んだ言語の1つの文字列です。

クラブにその言語のテキストがないとき、Crewcade は次の順で選びます。

  1. 選んだ言語。
  2. クラブの標準の言語。
  3. テキストがある任意の言語。
Terminal window
curl "https://api.crewcade.com/api/v1/events?locale=ja" \
-H "Authorization: Bearer cck_your_key_here"