身份证二要素认证

收起菜单

身份证二要素认证

1.概览

姓名+身份证号

2.接口说明

2.1请求URL

https://apis.shlianlu.com/identification/idCard/auth

2.2请求方式

POST

2.3请求包头定义

Accept: application/json

Content-Type: application/json;charset=utf-8

3.请求参数

MchId	String	是	企业ID：请登录联麓客户端点击（身份验证）进入概览页面获取	100***66
AppId	String	是	Appid：请登录联麓客户端点击（身份验证）进入概览页面获取	10*************00
name	String	是	姓名
idNum	String	是	身份证号
TimeStamp	String	是	Timestamp UNIX 时间戳	1647481897155
SignType	String	是	加密方式，固定值：MD5或者HMACSHA256	MD5
Signature	String	是	数字签名。拼接字符串AppId=XXX&MchId=XXX&SignType=MD5&TimeStamp=XXX&idNum=XXX&name=XXX&key=XXX，使用加密方式加密所得大写字符串。	7993CE14A565F418BAF745432A9990F5

Signature 签名机制详解

4.返回参数

返回状态	status	string	接口请求状态码
认证结果	data	Object	认证信息
返回信息	message	string	返回信息
返回响应	success	boolean	接口请求是否成功

5.示例

5.1请求示例

  
  {
    "MchId": "10****5",
    "AppId": "10****************11",
    "name": "谢*",
    "idNum": "3701**********1032",
    "SignType": "MD5",
    "TimeStamp": "1676872016736",
    "Signature": "B5642F5891EE0A5EB2A654D49E963543" 签名机制详解
}

5.2返回示例

  
  {
    "data": {
        "result": "01",（认证状态，01：认证一致，02：认证不一致，03：认证不确定，04：认证失败）
        "birthday": "19791226",
        "gender": "1",
        "province": "山东省",
        "authTime": "2023-02-20 15:25:20",
        "age": "43",
        "resultMsg": "一致"
    },
    "success": true,
    "status": "00"
}

6.错误码

参阅 API 错误代码