加载接口文档…
4
累计调用
109ms
平均响应
100.00%
服务可用性
访问限制
查看更多方案 →
文档链接
复制文档地址
https://apizero.cn/aidocs/idcard-face-3c/raw.md接口请求地址
https://v1.apizero.cn/api/idcard-face-3c
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/idcard-face-3c
接口信息备注
需要 API Key。按次计费 ¥0.15/次，核验失败也计费。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 必填 · 真实姓名（中文），兼容别名 realname · 示例：张三 |
| idcard | string | 必填 · 18 位身份证号（末位可为 X），兼容别名 id_card · 示例：11010519491231002X |
| image | string | 必填 · 人脸照片 base64（可带 data URL 前缀），兼容别名 face_image · 示例：data:image/jpeg;base64,... |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
| Content-Type | string | 可选 · 也支持 application/json |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 回显的姓名 |
| idcard | string | 脱敏后的身份证号 |
| valid | boolean | 是否一致：true=一致 |
| score | number | 人脸相似度（有则返回） |
| result_code | number | 100=一致 101=不一致 |
| message | string | 结果描述 |
| face | boolean | 固定 true，表示走人像三要素 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
免责声明
仅返回是否一致与相似度，不返回额外户籍信息；身份证号在响应中脱敏。须取得被核验人授权。