クイックスタート

1. 個人キーを作成する

Sofia アプリで 設定 › API を開き、個人アクセスタブでキーを作成します。名前、有効期限、権限を選んでください。キーは一度しか表示されません。コピーして、コードではなくシークレットストアに保管してください。

2. 最初の呼び出しを行う

キーを Authorization ヘッダーで送信します。GET /v1/me で、キーが誰のために動作するか、その Workspace と権限を確認できます。

bash

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

json

{
  "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"
}

3. 店舗を一覧表示する

すべての投稿は店舗に属します。投稿したい店舗の id を控えておいてください。

bash

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

次のステップ

最初の投稿に進む準備ができました。ブラウザから任意のエンドポイントを試すには、API リファレンスを開いて 試してみる を押してください。