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使用说明