API协议

本系统API基于HTTPS协议,您可以自行封装请求进行调用,以下对自行封装请求进行说明。

本章节主要内容:
1 调用地址
2 调用流程

1 调用地址

https://[hostname]:9080

2 调用流程

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

2.1 创建App

登录系统控制台,"系统接入" > "添加应用" 获取对接令牌(App Token) 和 对接密钥(App Secret)。

2.2 生成签名

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

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

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

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

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

2.3发起请求

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

2.4 得到响应

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

/本节结束/

上一篇:其他操作

下一篇:企业认证

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