1.5.1 实名类 API

优质

小牛编辑

126浏览

2023-12-01

身份证信息验证

接口描述

身份证信息验证

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
        }
    }
}