API协议

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

调用地址

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

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

调用流程

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

生成签名

所有开放平台的API接口,header中必须添加下面三个参数,用以校验身份。

(1)x-qys-open-accesstoken: 用来确认对接方身份,是申请开放平台后获取的 AppToken。

(2)x-qys-open-timestamp: 时间戳,Unix TimeStamp,单位为毫秒;

(3)x-qys-open-signature: 签名数据,用来校验请求是否有效。生成方式:Md5(AppToken + AppSecret + timestamp),即AppToken 和 AppSecret 和 时间戳拼接的字符串的MD5值。

API调用示例如下:

GET /v2/seal/list?selectOffset=0&selectLimit=2 HTTP/1.1
Host: openapi.qiyuesuo.cn
x-qys-open-timestamp: 1565753984643
x-qys-open-signature: 4e77af6b465c4080e25ecd012eaf2916
x-qys-open-accesstoken: DWjfxmA12a

发起请求

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

得到响应

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

帮助中心
联系我们
全国热线
400-888-9792