API协议

契约开放平台API基于HTTPS协议,您可以使用我们提供的SDK直接调用,也可以自行封装请求进行调用,以下对自行封装请求进行说明

调用地址

测试环境:https://openapi.qiyuesuo.cn

正式环境:https://openapi.qiyuesuo.com

调用流程

生成签名 > 封装请求 > 发起请求 > 得到响应

生成签名

在调用API时,需要为请求生成一个签名,并添加到请求包中,开放平台以此判断该请求是否被伪造或盗取。签名步骤如下:

1 查看您申请的Access Token和Access Secret。假设您的Access Token为123456,Access Secret为abcde。

2 将Access Token + Access Secret + Timestamp拼成字符串作为签名原文,如:“123456abcde1489391828093”。

3 对原文作MD5签名。如:HEX(MD5(原文字符串))=“bf3647db5f2f2f50ac2f2af744e44388”

4 将签名结果(x-qys-open-signature)、Access Token(x-qys-open-accesstoken)、Timestamp(x-qys-open-timestamp),作为自定义字段拼装到HTTP请求头中。

发起请求

请求的URL需要URL编码,详情参考API文档。

得到响应

API的响应包的Body部分采用JSON格式编码,因此需要对返回包进行JSON解析。

/本节结束/

上一篇: FAQ

下一篇: API使用说明

联系我们
全国热线
400-888-9792