アカウント

自分の情報を取得する

呼び出したトークンの種類、アプリケーション、代理する人、Workspace、スコープ、モード、有効期限を返します。有効なトークンなら読み取れます。

GEThttps://api.sofia-post.com/api/v1/me

自分の情報を取得する

curl -X GET 'https://api.sofia-post.com/api/v1/me' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "tokenType": "personal_key",
  "application": {
    "id": "string",
    "clientId": "sofia_app_live_3f9c…",
    "name": "Atelier CRM"
  },
  "user": {
    "id": "string"
  },
  "coverage": "workspace",
  "workspaces": [
    {
      "id": "string",
      "name": "Bistrot Lumière Lyon 2e"
    }
  ],
  "scopes": [
    "establishments:read"
  ],
  "mode": "test"
}

自分の情報を取得する

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/me' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "tokenType": "personal_key",
  "application": {
    "id": "string",
    "clientId": "sofia_app_live_3f9c…",
    "name": "Atelier CRM"
  },
  "user": {
    "id": "string"
  },
  "coverage": "workspace",
  "workspaces": [
    {
      "id": "string",
      "name": "Bistrot Lumière Lyon 2e"
    }
  ],
  "scopes": [
    "establishments:read"
  ],
  "mode": "test"
}

最初の呼び出し

キーを Authorization ヘッダーに入れて送ります。GET /v1/me で、キーが誰のために動作するか、その Workspace と権限が分かります。

curl https://api.sofia-post.com/api/v1/me \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "tokenType": "personal_key",
  "user": { "id": "cmo7qiltc0000sb1p7zdx1aw4" },
  "coverage": "account",
  "workspaces": [{ "id": "cmo7qiltc0000sb1p7zdx1aw4", "name": "160 food" }],
  "scopes": ["establishments:read", "posts:read", "posts:write"],
  "mode": "live",
  "expiresAt": "2026-11-09T20:09:05.644Z"
}

まだキーがありませんか？設定 › API › 個人アクセスで作成してください。認証をご覧ください。

認可

Authorizationstringheader必須
個人キーまたは OAuth アクセストークン。Bearer <token> として送信します。

レスポンス

呼び出したトークンの ID とスコープ。

tokenTypestring必須
トークンの種類：personal_key、authorization_code、または client_credentials
使用できる値： personal_keyauthorization_codeclient_credentials
applicationobject必須
トークンの元になっているアプリケーション
子属性を表示
- idstring必須
  アプリケーションの ID（または個人キーの ID）
- clientIdstring必須
  アプリケーションの client_id
- namestring必須
  アプリケーションの名前
userobject必須
トークンが代理する人
子属性を表示
- idstring必須
  トークンが代理する人：キーの作成者、または同意した人
coveragestring必須
workspace：1 つの Workspace。account：キーの作成者が属するすべての Workspace
使用できる値： workspaceaccount
workspacesobject[]必須
トークンが現在操作できる範囲
子属性を表示
- idstring必須
  Workspace の ID
- namestring必須
  有効な店舗の名前に由来する名称
scopesstring[]必須
トークンが持つスコープ
modestring必須
test または live
使用できる値： testlive
expiresAtstring<date-time>
トークンの有効期限。期限のないキーでは含まれません

このページは役に立ちましたか？