门店创建连接链接
返回 Sofia

门店

创建连接链接

返回托管链接，用户在 Sofia 上授权网络，因此网络令牌不会到达你的应用。链接有效期 30 分钟，仅限正式应用使用。

POSThttps://api.sofia-post.com/api/v1/establishments/{id}/connection-links
POST/v1/establishments/{id}/connection-links

此请求将作用于你的真实账户。

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

授权

  • Authorizationstring必填

    你的个人密钥或 OAuth 访问令牌，以 Bearer <token> 发送。

路径参数

  • idstring必填

    门店的标识符。

请求体

application/json

  • platformstring必填

    要连接的网络

    允许的值： instagramfacebooktiktoklinkedinx

  • redirectUrlstring

    最后把用户送到的地址，仅当 Sofia 认可该来源；否则由 Sofia 页面告知已完成

响应

201application/json

托管连接链接及其过期时间。

  • platformstring必填

    要连接的网络

  • urlstring必填

    用户打开以连接网络的 Sofia 页面

  • expiresAtstring必填

    链接等待点击的截止时间（ISO 8601）

401

令牌缺失、未知、已过期或已被撤销。

402

subscription_required。

403

测试应用返回 live_mode_required，或缺少 accounts:write scope。

404

不在令牌所属 Workspace 内的门店。

409

account_already_connected：该网络已连接。

422

platform_not_offered：未提供该网络。

4XXapplication/json

其他任何错误，以错误结构返回。