加载接口文档…
8K
累计调用
1005ms
平均响应
100.00%
服务可用性
20 次/日
免费额度
访问限制
查看更多方案 →未携带 API Key
无匿名额度，须携带 API Key
登录免费
每天 20 次 · QPS 2
免费试用
一次性 5 次
黄金会员
每天 50,000 次 · QPS 10
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120
接入文档
接口请求地址
https://v1.apizero.cn/api/ocr-health-cert
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/ocr-health-cert?input_type=url&input_data=https%3A%2F%2Fexample.com%2Fhealth-cert.jpg
接口信息备注
需要 API Key（Authorization: Bearer ）。登录用户每日免费额度见套餐。
请求参数说明
input_typestring
必填 · 图片传输方式：url（公网图片地址）或 base64 · 示例：url
input_datastring
必填 · 图片内容：url 时填 http/https 链接；base64 时填编码串（可含 data:image/xxx;base64, 前缀），≤10MB · 示例：https://example.com/health-cert.jpg
| 名称 | 类型 | 说明 |
|---|---|---|
| input_type | string | 必填 · 图片传输方式：url（公网图片地址）或 base64 · 示例：url |
| input_data | string | 必填 · 图片内容：url 时填 http/https 链接；base64 时填编码串（可含 data:image/xxx;base64, 前缀），≤10MB · 示例：https://example.com/health-cert.jpg |
请求头说明
Authorizationstring
可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
Content-Typestring
可选 · 请求体格式
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
| Content-Type | string | 可选 · 请求体格式 |
返回字段说明
namestring
持证人姓名
genderstring
性别，男或女。票面没有则为空
agestring
年龄。票面没有则为空
birthstring
出生日期，YYYY-MM-DD。能从证件号读出时填写，否则为空
id_numberstring
证件号码。按票面原文返回，掩码星号保留，不补全被挡住的位数
cert_numberstring
健康证编号 / 体检编码
industrystring
行业类别，如公共场所、食品
exam_itemsstring
体检项目。多项用分号连接；能读到结果时为「项目:结果」
exam_resultstring
体检结论，如合格
issued_bystring
发证机关 / 体检单位
date_of_handlingstring
办证日期，YYYY-MM-DD。票面没有则为空
date_of_issuestring
发证日期，YYYY-MM-DD
date_of_medical_examinationstring
体检日期，YYYY-MM-DD。票面没有则为空
valid_datestring
有效期至，YYYY-MM-DD
ocr_msnumber
识别耗时（毫秒）
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 持证人姓名 |
| gender | string | 性别，男或女。票面没有则为空 |
| age | string | 年龄。票面没有则为空 |
| birth | string | 出生日期，YYYY-MM-DD。能从证件号读出时填写，否则为空 |
| id_number | string | 证件号码。按票面原文返回，掩码星号保留，不补全被挡住的位数 |
| cert_number | string | 健康证编号 / 体检编码 |
| industry | string | 行业类别，如公共场所、食品 |
| exam_items | string | 体检项目。多项用分号连接；能读到结果时为「项目:结果」 |
| exam_result | string | 体检结论，如合格 |
| issued_by | string | 发证机关 / 体检单位 |
| date_of_handling | string | 办证日期，YYYY-MM-DD。票面没有则为空 |
| date_of_issue | string | 发证日期，YYYY-MM-DD |
| date_of_medical_examination | string | 体检日期，YYYY-MM-DD。票面没有则为空 |
| valid_date | string | 有效期至，YYYY-MM-DD |
| ocr_ms | number | 识别耗时（毫秒） |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"name": "张三",
"gender": "男",
"age": "32",
"birth": "",
"id_number": "110101199001011234",
"cert_number": "JKZ20240115001",
"industry": "食品加工",
"exam_items": "",
"exam_result": "合格",
"issued_by": "某某市卫生健康委员会",
"date_of_handling": "2024-01-15",
"date_of_issue": "2024-01-20",
"date_of_medical_examination": "2024-01-10",
"valid_date": "2025-01-19",
"ocr_ms": 4200
},
"request_id": "abc123",
"tips": "极数本源 · https://apizero.cn"
}