REST API 与 API 密钥(集成)
通过带密钥认证的 REST API 将 CRM 与其他系统集成。
Sellio 提供 REST API,供你从其他系统(Zapier、Make、你自己的脚本等)读写记录。访问需要通过在"设置 → API 与密钥"中生成的 API 密钥进行认证。
生成密钥
- 前往"设置 → API 与密钥"。
- 给它起个名字(例如"Zapier 集成"),然后点击"生成密钥"。
- 立即复制密钥:它只会显示一次,之后无法再找回。
- 若要关闭某个集成,使用"撤销",该密钥会立即失效。
💡 该密钥可完全访问你组织的数据。请像对待密码一样对待它:切勿在公开代码或浏览器中暴露它。
端点
- GET /api/v1/{object}:列出记录(参数:limit、offset、search)。
- GET /api/v1/{object}/{id}:获取单条记录。
- POST /api/v1/{object}:创建记录(JSON 请求体包含字段)。
- PATCH /api/v1/{object}/{id}:更新记录的字段。
在请求头中发送密钥:Authorization: Bearer sk_live_… 其中 {object} 是对象的 API 名称(contact、company、lead、opportunity 或你自己创建的对象)。
示例: curl -H "Authorization: Bearer sk_live_..." https://www.selliocrm.com/api/v1/opportunity
💡 该 API 遵循与 CRM 相同的校验和业务规则(必填字段、校验规则等),与通过界面操作完全一致。
速率限制与用量(SLA)
每个密钥都有每分钟请求次数的限制(默认 120 次),可在密钥列表中直接调整。每个响应都会带有以下请求头:X-RateLimit-Limit(上限)、X-RateLimit-Remaining(当前窗口内还剩多少次)以及 X-RateLimit-Reset(窗口重置的时刻,以 epoch 时间表示)。
超出限制时,API 会返回 429(请求过多),并带有 Retry-After 请求头,指明需要等待多少秒后再重试。密钥页面还会显示每个密钥已发出的请求总数(用量指标)。
💡 请根据你的用量设置限制:0 表示不限制该密钥。对第三方集成使用较小的限制,对可信的内部负载使用较大的限制。