快速开始

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 参考并点击试用。