开发指南

对接地址

正式环境地址：https://api.keceyun.com

统一采用HTTP POST请求
数据传输编码为UTF-8（charset:UTF-8）
所有数据均为JSON格式（Content-Type:application/json）

所有接口：3次/秒

每次接口请求中除正常业务请求参数外，还需要携带鉴权参数（使用 HTTP Header 传递）：

字段	说明
appid	应用id，用于指明调用者身份。
token	随机生成字符串，参与签名。不需要在header中传递
timestamp	请求时间戳。目前只参与签名，后续会验证如果请求时间戳与服务器时间相差过大，接口将可能拒绝当次请求
sign	当次请求消息签名值。计算方式见后文。

如您的appid为appid123456，token为1233445，timestamp为1715239424(精确到秒)，请求参数为（消息体无换行，无结尾空白）

{"province_name":"江苏"}

签名步骤：

连接appid、时间戳、请求消息体、token，组成待签名文本。按此例数据，待签名文本应为

appid1234561715239424{"province_name":"江苏"}1233445

对待签名文本计算 SHA256 摘要值，以16进制表示，即为最终签名值。本例结果为

e8018e6dc3f33f7d5af0c900dd6848a3711e4e38105a0e5ed1ef0ad318f45e75

header

appId:appid123456
timestamp:1715239424
sign:e8018e6dc3f33f7d5af0c900dd6848a3711e4e38105a0e5ed1ef0ad318f45e75

body

调用参数格式统一为 JSON （Content-Type: application/json），UTF8编码

{"province_name": "江苏"}

响应内容统一为使用 UTF8 编码。

响应格式为 JSON，且有统一的外层结构。