1

准备 Connector API 地址

export CONNECTOR_API_BASE="https://open.tui161.com/api/connector/v1"
2

激活连接器

使用 SaaS 授权码换取站点 token。
curl -X POST "$CONNECTOR_API_BASE/auth/activate" \
  -H "Content-Type: application/json" \
  -d '{
    "licenseKey": "YOUR_LICENSE_KEY",
    "domain": "YOUR_CUSTOMER_SITE_ORIGIN",
    "platform": "custom",
    "locale": "zh-CN"
  }'
3

在服务端保存 token

返回的 site token 是服务端密钥,只能保存在插件服务端、后端服务或客户站点代理中。
4

检查站点状态

curl "$CONNECTOR_API_BASE/site/status" \
  -H "Authorization: Bearer YOUR_SITE_TOKEN"
5

提供浏览器安全代理

浏览器只请求客户站点自己的代理接口。代理服务端再携带 site token 调用 GrowthOS。

常用请求头

Authorization: Bearer <site_token>
Content-Type: application/json
Idempotency-Key: <stable-operation-key>
内容同步、访客消息、任务领取和任务完成等写操作都应携带稳定的 Idempotency-Key