目录 (Table of Contents)
实名类相关接口
身份证信息验证
接口描述
身份证信息验证
URL
/identity/authentication
HTTP Method
POST
请求参数
| 参数名称 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| name | 是 | string | 姓名 |
| idNumber | 是 | string | 身份号码 |
返回参数
| 参数名称 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| resultCode | 是 | int | 身份验证结果 |
| resultDesc | 是 | string | 身份验证结果描述 |
HTTP请求示例
POST /identity/authentication HTTP/1.1
Host: api.miot.10046.mi.com
Date: Thu, 15 May 2014 11:18:32 GMT
H-XM-AppId: 开放平台分配给接入方的appId
H-XM-V: 2.0 //接口版本号
Authorization: 参考Authorization加签规则
Content-Type: application/json;charset=UTF-8
{
"name":"小米", //string.姓名
"idNumber":"..." //string.证件ID
}
成功响应示例
HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 556
Connection: keep-alive
Server: resin4.0.13
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 1
X-RateLimit-Reset: 60000 // 单位毫秒
XM-Request-Id: 97ad742e-7a17-42fa-ad05-b5e559699335 // 接口本次请求的唯一标识.UUID version 4.由服务端生成
{
"rtnCode": 0,
"rtnMsg": "success",
"data":{
"resultCode":0,
"resultDesc":"验证通过"
}
}
实名照片上传
接口描述
实名照片上传
URL
/identity/photos
HTTP Method
POST
请求参数
| 参数名称 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| photoType | 是 | int | 照片类型 |
| photoBase64Str | 是 | string | 要上传的照片的base64字符串 |
| phoneNumber | 是 | string | 手机号 |
| operator | 是 | string | 操作人 |
返回参数
| 参数名称 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| identityInfo | 是 | object | 身份信息 |
HTTP请求示例
POST /identity/photos HTTP/1.1
Host: api.miot.10046.mi.com
Date: Thu, 15 May 2014 11:18:32 GMT
H-XM-AppId: 开放平台分配给接入方的appId
H-XM-V: 2.0 //接口版本号
Authorization: 参考Authorization加签规则
Content-Type: application/json;charset=UTF-8
{
"photoType":10,
"photoBase64Str":"xxx",
"phoneNumber":"xxxx",
"operator":""
}
成功响应示例
HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 556
Connection: keep-alive
Server: resin4.0.13
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 1
X-RateLimit-Reset: 60000 // 单位毫秒
XM-Request-Id: 97ad742e-7a17-42fa-ad05-b5e559699335 // 接口本次请求的唯一标识.UUID version 4.由服务端生成
{
"rtnCode": 0,
"rtnMsg": "success",
"data":{
"identityInfo":{
"bucket":"identity",
"photoId":"a873c134-02fa-4507-b16a-6136dd0bad13",
"photoType":10
}
}
}