自分とクラブ
このエンドポイントで、アプリはメンバーが誰か、どのクラブと話しているかを知ります。すべての /v1 ルートで言語がどう働くかも説明します。
サインイン中のメンバーを読む
Section titled “サインイン中のメンバーを読む”GET /meこのエンドポイントにはメンバートークンが必要です。メンバートークンはCrewcade でサインインで得ます。APIキー では使えません。
curl https://api.crewcade.com/api/v1/me \ -H "Authorization: Bearer ccm_your_member_token"返事には、メンバーが許可した項目だけが入ります。
| スコープ | 返事の項目 |
|---|---|
profile | id、name、nameText、photoUrl |
email | email、emailVerified |
{ "id": "mem_123", "name": { "en": "Alex Kim", "ja": "アレックス・キム" }, "nameText": "アレックス・キム", "photoUrl": null, "emailVerified": true}idはメンバーIDです。IDトークンのsubと同じ値です。- メンバーに実際のメールアドレスがないとき、
emailはnullです。 profileスコープがないと、名前と写真の項目は入りません。emailスコープがないと、メールの項目は入りません。
クラブを読む
Section titled “クラブを読む”GET /workspaceこのエンドポイントは、APIキー でもメンバートークンでも使えます。返事はどちらも同じです。
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 は次の順で選びます。
- 選んだ言語。
- クラブの標準の言語。
- テキストがある任意の言語。
curl "https://api.crewcade.com/api/v1/events?locale=ja" \ -H "Authorization: Bearer cck_your_key_here"