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解析。