门店与账号

获取 API 密钥

端点

GET/v1/establishmentsGET/v1/establishments/{id}/accountsPOST/v1/establishments/{id}/connection-links

门店是拥有自己网络、媒体和帖子的一家商家、一个品牌或一个地点。一个 Workspace 包含一家或多家门店。

已连接的账号

GET /v1/establishments/{id}/accounts 列出已连接的网络：平台、用户名、名称、头像和状态。Sofia 绝不会交出网络的令牌。

连接缺少的网络

创建托管连接链接并将所有者引导过去。链接有效期为 30 分钟；结束时，如果 Sofia 认可其来源，会将用户送回你的 redirectUrl。

bash

curl -X POST https://api.sofia-post.com/api/v1/establishments/$ESTABLISHMENT_ID/connection-links \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"linkedin","redirectUrl":"https://app.example.com/sofia/connected"}'

已连接的网络返回 409 account_already_connected；Sofia 不提供的网络返回 422 platform_not_offered。