适用场景

  • 贵司已有官网、商城、客服系统，想把线索直接写进 CRM
  • 需要把 CRM 的客户、合同数据同步到自建的数据仓库
  • ERP / OA / 飞书等暂无开箱即用连接器时，用开放接口自行对接

认证方式

所有开放接口都需要在请求头带上密钥：

```

X-Api-Key: <你的密钥>

```

缺失或密钥失效会返回 401。密钥可以设置有效期、总调用量上限和权限级别，

默认限流为每分钟 60 次，按密钥独立计算。

获取密钥

密钥由商务在开通时下发，或在系统「系统管理 → 开放平台」里自助创建。

外部开发者可在官网申请沙箱密钥。

可用接口

当前开放的接口覆盖客户、线索、合同三类核心数据的查询与创建。

完整清单、请求参数与 curl 示例见官网 API 文档概览。

常见问题

返回 401？

检查请求头名称是否为 X-Api-Key（区分大小写），以及密钥是否已过期。

返回 429？

触发了限流。降低调用频率，或联系商务调整该密钥的限流配额。

接口不够用？

把你的场景告诉我们，开放接口会按客户需求持续扩展。