身份证实名认证 #

描述 #

使用此接口通过 AI&API 能力校验姓名和身份证号是否一致。调用前需为开放应用添加并签约 AI 能力，能力ID为 60，且能力余额充足。

接口说明 #

授权对象 APP

请求地址 POST /open/ai/api/idcheck

请求规则请查阅开发必读

请求参数 #

参数名称	变量名称	参数类型[长度限制]	是否必填	描述
身份证号	cardNo	string	是	body 示例值：330329199001021122
真实姓名	realName	string	是	body 示例值：李四

请求示例 #

{
  "cardNo": "330329199001021122",
  "realName": "李四"
}

响应参数 #

接口返回身份证实名认证结果，data 内字段按上游数据转换后返回。

参数名称	变量名称	参数类型	是否必填	描述
真实姓名	realName	string	否	已脱敏姓名示例值：李*
身份证号	idCard	string	否	已脱敏身份证号示例值：330329********1122
是否匹配	match	bool	是	true 表示姓名和身份证号一致，false 表示不一致示例值：true
身份证信息	info	object	否	身份证归属地等信息，认证失败时可能为空

身份证信息 info #

参数名称	变量名称	参数类型	是否必填	描述
省份	province	string	否	示例值：浙江省
城市	city	string	否	示例值：温州市
区县	district	string	否	示例值：文成县
地区	area	string	否	示例值：浙江省温州市文成县
性别	sex	string	否	示例值：男
出生日期	birthday	string	否	示例值：1990-01-02

响应示例 #

{
  "code": 20000,
  "msg": "success",
  "data": {
    "realName": "李*",
    "idCard": "330329********1122",
    "match": true,
    "info": {
      "province": "浙江省",
      "city": "温州市",
      "district": "文成县",
      "area": "浙江省温州市文成县",
      "sex": "男",
      "birthday": "1990-01-02"
    }
  }
}