API: Factor/detail


概览


factor/detail 是 SUBMAIL 的详版身份验证 API,可以根据身份证、手机号和姓名获取到验证信息和手机运营商信息。



URL


<主> http://tpa.mysubmail.com/factor/detail



支持格式


*格式**URL*
jsonhttps://tpa.mysubmail.com/factor/detail.json(默认)
xmlhttps://tpa.mysubmail.com/factor/detail.xml


http 请求方式


请求方式content-type 设置
http postmultipart/form-datax-www-form-urlencodedapplication/json


是否需要授权


参阅 API 授权和验证机制


请求参数


参数类型必需/可选默认描述
appidstring必需三要素appid,自控制台获取
timestampstring必需时间戳
namestring必需待验证的身份证姓名
idNoUnix 时间戳必需待验证的身份证号码
mobilestring必需待验证的号码
signaturestring必需sha256加密校验数字证书


代码示例


发送验证到


POST

http://tpa.mysubmail.com/factor/detail

POST Data

​ appid=your_app_id×tamp=1605521294832&name=张三&idNo=310000xxxxxxxxxxxx&mobile=130xxxxxxxx&signature=sha256加密后字符串


返回
{

​      "status": "success",

​      "identical": "true",

​      "provider": {

​         "provider": -2,

​         "data": "1"

​       },

​    "send_id": "4cf22ecb12342a5442df58c829a86690"

}


请求失败
{

​    "status": "error",

​    "code": 1210,

​    "msg": "Empty APP ID."

}


错误代码


​ 参阅 API 错误代码