API: Factor/detail - 详版运营商三要素

概览

​ factor/detail 是 SUBMAIL 的详版身份验证 API，可以根据身份证号码、手机号码和姓名判断三者是否一致，并获取部分运营商相关信息。

URL

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

http 请求方式

signature创建规则

1.请将以下参数按照字段升序（A-Z）排列
appkey、idNo 、mobile、name、timestamp

2.创建签名字符串 ：以"key=value" + "&"（连接符）+ "key=value" 的方式连接所有参数

3.创建签名：拼接签名字符串示例string = "appkey=xxxx&idNo=xxxx&mobile=188xxxx&name=张三& timestamp=1614759954"，然后使用sha256(string)创建签名

注：中文需要使用urlencode处理后再参与创建签名

请求参数

返回参数格式

jsonString

代码示例

详情请查询demo示例文档

响应消息

API请求失败
{
        // 状态描述
        'status'  : 'error' ,
        // API流水号
        'send_id' : "********************************",
        // API返回的状态码    详情查看 API错误代码与描述  文档
        'code'    : 1217 ,
        // API返回的描述
        'msg'     : 'Incorrect APP ID.' ,
}
{
    "status": "error",
    "send_id": "********************************",
    "code": 1217,
    "msg": "API Gateway Error:身份证格式错误(****)"
}

API请求成功
{
        "status": "success",
        "send_id": "********************************",
        "result": {
                //true 一致   false 不一致
                "identical": true,
                //01 一致       02 不一致
                "status": "01",
                //运营商编码   1中国移动    2中国联通   3中国电信  0查询失败
                "ope_type": 2,
                //运营商中文名称
                "provider": "中国联通",
                //返回结果描述
                "msg": "一致",
        }
}
identical和status 参数意义相同

//认证不一致
{
        "status": "success",
        "send_id": "********************************",
        "result": {
                "identical": false,
                "status": "02",
                "ope_type": "2",
                "provider": "中国联通"
                "msg": "认证不一致，手机号匹配成功，姓名匹配失败，身份证匹配失败",
        }
}

错误代码

​ 参阅 API 错误代码