文档概述
版本说明
- v2.0(key密文):sign由key+参数拼接 SHA256算法加密后的密文参数
- v1.1(明文key):接入简单,GET请求,URL后面key参数是明文,容易造成KEY泄露
接入说明
- 所有接口 GET/POST 请求(GET:key明文 / POST:key+其它参数拼接加密)
- 请求格式:form-data表单数组,响应格式:JSON
-
接口域名:
https://gsdapi.com
接口参数详情
接口地址:
https://gsdapi.com/api/v2/Pos
请求方式:
POST
请求参数
| 参数名 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| uid | String | 是 | 系统分配的用户ID |
| time | String | 是 | 当前提交接口查询的时间(年月日时分秒) |
| sign | String | 是 | sign加密字符串(详见sign加密方法) |
| posid | String | 是 | 需要查询的商户号15位长度 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| RESULT | Integer | 返回码 1查询有结果 0查询无结果 -1异常错误 |
| MESSAGE | String | 返回码说明 |
| Posid | String | 商户号 |
| Posname | String | Pos机发行机构 |
请求示例
uid=1000012345 time=20211208101858(注:2021-12-08 10:18:58 当前查询时间去掉时间当中的- :) sign=67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3 posid=847A00550949818 需要查询的商户号 以上参数POST form-data是数组
响应示例
{
"RESULT": "1",
"MESSAGE": "查询成功",
"Posid": "847A00550949818",
"Posname": "深圳中付电子支付科技有限公司"
}
sign拼接加密说明
sign拼接加密码方法
加密使用了SHA256算法
加密字符串为:用户ID(uid)+当前时间(time)+用户KEY(APIkey) 连接拼成的长字符串
示例:uid=1000012345
time=20211208101858(注:2021-12-08 10:18:58 去掉时间当中的- :)
apikey=145b9c7f6aa67377bb664521007079a9
拼接后的字符串uid+time+apikey:100001234520211208101858145b9c7f6aa67377bb664521007079a9
sha256加密后字符:67bec755ce5704222a4ece083493dd3d54686281f4a80b83e1de277b860f34a3