接口描述

提供基于权威库的实名认证服务，支持二代居民身份证的三要素（姓名、身份号码+人像正脸照片）核验。

请求方法

POST

接口要求

• 图片格式限制：支持 jpeg格式，BASE64 字符串无需包含格式头，注意去除换行符
• 图片大小限制：原始尺寸需压缩至 10~40KB，否则可能会因为过小或过大而导致人像比对不通，影响比对效率；

请求URI

/v1/aiop/api/348c0ca2pkw0/gcapi/simpauth66

请求参数

1.请求头header参数

2.请求体body参数

请求代码示例

Curl -X POST
"https://ai-global.ctapi.ctyun.cn/v1/aiop/api/348c0ca2pkw0/gcapi/simpauth66"
-H "Content-Type: application/json"
-H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
-H "appkey:XXX"
-H "Eop-Authorization:XXX"
-H "eop-date:20211109T104641Z"
-H "host:ai-global.ctapi.ctyun.cn"
--data '{"portrait": "_9j_4AAQSkZJRgA...","idNum": "13x6xx199x07xx98xx","fullName": "龙傲天"}'

返回值说明

1.请求成功返回响应参数

认证结果代码说明

第一字节说明

第二字节说明

返回值示例

1.请求成功返回值示例

{
  "certToken": "d182ca85-xxxx-xxxx-xxxx-868cb258ceab",
  "resStr": "00XX",
  "statusCode": 0,
  "retMessage": "成功"
}

2.请求失败返回值示例

{
  "statusCode": 1,
  "retMessage": "接口调用失败"
  "error":"AI_OP_4101"
}

状态码

错误码说明

base64 编码规则：使用常规的 safe base64 编码方式

• python 中推荐使用 base64.urlsafe_b64encode() 函数进行编码。
• java 中推荐使用 BASE64.getUrlEncoder().encodeToString() 函数进行编码。