接口URI | https://apiztfw.suzhou.gov.cn:7443/rs/4u3sj/szdtysfrz | |||||
---|---|---|---|---|---|---|
请求类型 | Restful | |||||
请求方式 | GET | |||||
请求头 | 参数名 | 参数值 | 是否必须 | |||
Authorization | Bearer XXXXXXXXXXXXX (Bearer后面的值 为 1.2 获取Authorization接口返回的accessToken) |
是 | ||||
Content-Type | application/x-www-form-urlencoded | 是 | ||||
accessToken | 81181a01594449c6ac218d06a2e6ed6c ( H5调用 getToken 或 getNewToken 方法返回的token值 ) | 是 | ||||
clientId | 固定值(申请苏周到APP统一身份认证获得的ClientId) | 是 | ||||
time | 20200903165420 | 是 | ||||
sign | 32333878862f99f25ad24b6fac63d50 | 是 | ||||
appVersion | 0.0.1 | 固定值 | ||||
接口描述 | 获取用户信息接口 | |||||
请求头示例 | Authorization:Bearer QUMwNDZGM0JBMTRGRkQ4QzlEOTVEOEM= Content-Type:application/x-www-form-urlencoded accessToken:3fc2f446c8974e6f80576ab0aa473dd2 clientId:E70VLP51Z time:20200903165420 sign:32333878862f99f25ad24b6fac63d50 appVersion:0.0.1 |
|||||
返回值格式 | { “msg”: “success”, “code”: “200”, “data”: “0Bi6yc8ngaurbKALSCTICWAB1qlv+BOr62opgirx+HU1G07LfvgvuDTXf2iOZvdPiqBF3l5H8lnW4KAAAUCTdQ==”, “timestamp”: “1599134861990” } |
|||||
序号 | 字段名 | 字段描述 | 备注 | |||
1 | msg | 返回信息 | 返回码描述 | |||
2 | code |
返回编码 | 返回码 code = 200 | |||
3 | 信息主体data | nOleVLNqUYuf/zLPJtFK+elJVuDjcV/MDVtqb7B2BN8VsFukdZE9KBqujBxeBu/vn+166HKknwjLdlb39QTeb7k4aijI+qeB9CL5xS7n26DGvjro2uoxV+9TEzfTL6b/eSUX2Qo8wSu3M8tVqwKHsg== | 返回的用户详细数据,经过 AES 加密,解密后的数据详见 data 包含的元素说明(解密私钥是苏周到提供的clientSec,解密方式由苏周到提供) |
1. data 里面数据用 AES 私钥(即 clientSec)解密后对应如下(详见:1.6 解密工具类):
“{\”id\”:\”1285831815907135488\”,\”name\”:\”张三\”,\”idCard\”:\”323005199008031234\”,\”mobile\”:\”18151071056\”}”
2. data 包含的元素说明(详见“苏周到”APP 用户授权访问申请表)
参数名 | 中文描述 | |
---|---|---|
id | 唯一id | |
mobile | 用户名/手机号 | |
name | 实名 | 需申请 |
idCard | 身份证 | 需申请 |
3.状态码说明
状态码 | 描述 | 备注 |
---|---|---|
200 | 调用成功 | |
210126 | 不合法的客户端 | 原因:请检查clientId是否填写正确 |
210128 | 签名错误 | client参数与签名sign不匹配(原因:请检查经过clientId、clientSec、time加密后的字符串是否和sign一致) |
401 | 帐号验证失败,请重新登录 | token无效 |