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