实名认证查询
1.描述: 获取指定用户的实名认证资料
2.接口地址:
请求路径:
/ws-rest/v1/users/{user-id}/auth
请求头:
采用HMAC认证
3.请求方式:
GET
4.请求参数说明
a.请求示例
curl -X GET \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Date: Wed, 02 Nov 2016 03:25:54 GMT" \
--header "User-Agent: SignIt RestAPI Client v1.0.0" \
--header "Host: api.signit.cn" \
--header "Authorization:HmacSHA512 a1S0H2-U0-v5I-0586-017-z6D-7B5-K0h-1o0-G0-9923G3Xm:53f7ae4a-937b-4ddc-8872-42dd094d56eb:NCMwvHfZS9ZzB2SgVbRzTuS/N5yDRM8Ak6tRvCavHD5T9nKjydc9ha+Rj48e0YIFC5V9IRtFL8Z1d0hvse7Ulg==" \
"https://api.signit.cn/ws-rest/v1/users/259/auth?type=1&fields=null"
b.请求字段说明
字段 | 必填 | 类型 | 位置 | 说明 |
---|---|---|---|---|
user-id | 是 | Number | URL-PATH | 用户ID属性值 |
type | 是 | Number | QUERY | 认证类型,1-个人认证;2-企业认证 |
fields | 否 | String | QUERY | 字段选择,默认为null |
5.响应参数说明
a.响应示例
- 响应成功
{ "resultStatusCode": "100220022", "resultCode": 0, "resultDesc": "个人认证信息查询成功", "resultData": { "name": "testName", "phone": "12345678", "idCardCode": "12345678", "submitDate": 1462439511000, "state": 2 } }
- 响应失败:
b.响应字段说明
{ "resultStatusCode": "100220122", "resultCode": 1, "resultDesc": "认证资料信息不存在" }
字段 | 必填 | 类型 | 位置 | 长度 | 说明 |
---|---|---|---|---|---|
resultStatusCode | 是 | String | BODY | 固定值 | 结果状态码 |
resultCode | 是 | Number | BODY | 固定值-0,1 | 结果码,0-成功,1-失败,具体含义见结果状态码 |
resultDesc | 是 | String | BODY | 操作结果说明 | |
resultData | 是 | Object | BODY | 查询返回结果,包含查询结果的封装 | |
name | 是 | String | BODY | 真实姓名 | |
phone | 是 | String | BODY | 认证手机号 | |
idCardCode | 是 | String | BODY | 身份证号 | |
submitDate | 是 | Number | BODY | 提交时间 | |
state | 是 | Number | BODY | 审核状态:0-未审核(资料不完善) 1-审核通过 2-等待审核(资料完善) 3-审核未通过 |