接口授权

接口申请

接口地址 https://api.kinyun.cn 。

本接口仅对注册了本系统的商户开放，未注册用户无法使用。

注册商户申请接口时，需要提供下列信息：

项目	说明
domain	商户的网站域名，用于确认商户的资质。
callbackUrl	使用 API 文档准备一个接口回调地址，用于接收 API 的回调信息。

请联系千云SCRM工作人员提供上述信息，审核后将为您的商户分配 appId 及 secret ，并提供回调消息解密用的 Token 和 EncodingAESKey。

使用令牌调用接口

开发者调用接口时必须先获得访问令牌（ACCESS_TOKEN）。

获取到令牌后，后续接口访问都将令牌放于请求 queryString 的 token 参数中。例如：

https://api.kinyun.cn/v1/echo.json?token=YOUR_ACCESS_TOKEN

令牌的有效时间为 2 小时(7200 秒)，请自行维持令牌的可用性。

在当前令牌过期之前，重复请求令牌将不会生成新的令牌。

IP白名单

API 服务器使用IP白名单对客户端进行限制，申请接口请同时提供调用 API 的客户端 IP 地址。

如有多个IP地址，请用逗号(,)或分号(;)隔开，例如：172.23.104.11,172.10.104.12。

支持 IP 区间配置；只支持IPv4的最后一段，例如: 172.23.104.10-172.23.104.24。不支持 172.23.10.1-172.23.255.255。

支持 IP 通配符(*)；只支持IPv4的最后一段，例如：172.23.104.*。不支持 172.23.*.* 或 *.*.*.*。

修改IP白名单，请联系工作人员进行配置。