运行中

免费额度

健康证识别

API

结构化识别从业人员健康证，提取姓名、性别、年龄、体检结论、有效期、体检编码、发证单位等字段。请求传 region=tj 时按天津电子健康证明识别，并返回地区代码与二维码真伪；不传则只返回通用字段。支持常见纸质证与电子健康证。可以上传整页截图，也可以只截证件卡片。入参为公网图片 …

接入文档接入 MCP

由极数本源提供·更新于昨天

先试用，再接接口

不用写代码。打开工具页跑一遍健康证识别，看清结果再来订阅。

打开健康证识别

累计调用

1005ms

平均响应

100.00%

服务可用性

20 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 2

今日已用 … / 20 次/日…

已登录并携带 API Key 时，可使用上方免费额度。各会员档额度见下方。

未携带 API Key

无匿名额度，须携带 API Key

登录免费

每天 20 次 · QPS 2

免费试用

一次性 5 次

黄金会员

每天 50,000 次 · QPS 10

钻石会员

每天 100,000 次 · QPS 30

企业会员

每天 1,000,000 次 · QPS 120

AI 文档

把这个地址发给 AI，就能生成调用代码

https://apizero.cn/aidocs/ocr-health-cert/raw.md

打开文档

接入文档

打开

接口请求地址

https://v1.apizero.cn/api/ocr-health-cert

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/ocr-health-cert?region=tj&input_type=url&input_data=https%3A%2F%2Fexample.com%2Fhealth-cert.jpg

接口信息备注

请求参数 region 传 tj 后，按天津电子健康证明识别，并返回 region、二维码真伪等天津字段。不传 region 走通用健康证，不返回这些字段。整页手机截图（含底部须知）或只截中间证件卡片都可以。二维码会提交已接入的天津官方渠道核验：通过且姓名、编号一致时 qr_verify 为真，发证机关、行业、发证日期、有效期、编号和体检结论以官方结果为准。编号或姓名对不上，或官方返回未知健康证明时为伪，不改写姓名和发证机关。图中解不出二维码时为未识别，文字字段仍返回。渠道未接入或请求失败时为无法核验；编号与票面一致但渠道未接入时同样是无法核验，不会判伪。红章挡住的检查项目可能只有名称、没有检测结果。

请求参数说明

region（地区）string

必填 · 版式。天津电子健康证明传 tj。传 tj 后按天津版式识别，并返回 region、二维码真伪等天津字段。不传则走通用健康证，不返回这些字段 · 默认 tj · 示例：tj

input_typestring

必填 · 图片传输方式：url（公网图片地址）或 base64 · 示例：url

input_datastring

必填 · 图片内容：url 时填 http/https 链接；base64 时填编码串（可含 data:image/xxx;base64, 前缀），≤10MB · 示例：https://example.com/health-cert.jpg

名称	类型	说明
region（地区）	string	必填 · 版式。天津电子健康证明传 tj。传 tj 后按天津版式识别，并返回 region、二维码真伪等天津字段。不传则走通用健康证，不返回这些字段 · 默认 tj · 示例：tj
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

证件号码。掩码星号按票面保留

industrystring

行业类别。查验为真时，以官方行业名称为准

exam_itemsstring

检查项目与检测结果，多项用分号连接，单项为「项目:结果」。红章挡住的行可能只有项目名。常见五项：细菌性痢疾、伤寒、病毒性肝炎(甲肝、戊肝)、活动性肺结核、化脓性或渗出性皮肤病

exam_resultstring

体检结论。证件写明合格，且没有不合格项时为合格。查验为真时，官方状态为合格或临期写合格，不合格写不合格；逾期不改结论

issued_bystring

发证机关。查验为真时改为官方机构名称

date_of_handlingstring

办证日期。天津电子证通常为空

date_of_issuestring

发证日期，YYYY-MM-DD。查验为真时以官方开始日期为准

date_of_medical_examinationstring

体检日期。天津电子证通常为空

valid_datestring

有效期至，YYYY-MM-DD。查验为真时以官方截止日期为准

cert_numberstring

编号，如 (M)DEMO202006010001。查验为真时以官方 markCode 为准

regionstring

地区代码。天津市电子健康证明固定为 tj。其它地区不返回此字段

qrcodestring

证件二维码原文，通常是官方查验链接。识别不到时为空字符串

qr_verifystring

真伪。真：官方查验通过，且姓名、编号与证件一致。伪：编号或姓名与官方记录不符，或官方返回未知健康证明；此时不改写姓名和发证机关。未识别：没有解出二维码，其余文字字段仍返回。无法核验：二维码不是已接入的天津查验渠道，或请求失败。编号与票面一致但渠道未接入时也是无法核验，不会判伪

qr_statestring

官方状态：合格、临期、逾期、不合格。没有查到时为空。逾期表示已过有效期，不表示证件是假的

qr_verify_msgstring

查验说明。例如「官方查验为合格」「官方查验为临期」「证明真实，当前已逾期」「未知健康证明」

ocr_msnumber

识别耗时（毫秒）

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

名称	类型	说明
name	string	持证人姓名
gender	string	性别，男或女
age	string	年龄
birth	string	出生日期，YYYY-MM-DD。从证件号中已露出的出生日期读出，不补全掩码
id_number	string	证件号码。掩码星号按票面保留
industry	string	行业类别。查验为真时，以官方行业名称为准
exam_items	string	检查项目与检测结果，多项用分号连接，单项为「项目:结果」。红章挡住的行可能只有项目名。常见五项：细菌性痢疾、伤寒、病毒性肝炎(甲肝、戊肝)、活动性肺结核、化脓性或渗出性皮肤病
exam_result	string	体检结论。证件写明合格，且没有不合格项时为合格。查验为真时，官方状态为合格或临期写合格，不合格写不合格；逾期不改结论
issued_by	string	发证机关。查验为真时改为官方机构名称
date_of_handling	string	办证日期。天津电子证通常为空
date_of_issue	string	发证日期，YYYY-MM-DD。查验为真时以官方开始日期为准
date_of_medical_examination	string	体检日期。天津电子证通常为空
valid_date	string	有效期至，YYYY-MM-DD。查验为真时以官方截止日期为准
cert_number	string	编号，如 (M)DEMO202006010001。查验为真时以官方 markCode 为准
region	string	地区代码。天津市电子健康证明固定为 tj。其它地区不返回此字段
qrcode	string	证件二维码原文，通常是官方查验链接。识别不到时为空字符串
qr_verify	string	真伪。真：官方查验通过，且姓名、编号与证件一致。伪：编号或姓名与官方记录不符，或官方返回未知健康证明；此时不改写姓名和发证机关。未识别：没有解出二维码，其余文字字段仍返回。无法核验：二维码不是已接入的天津查验渠道，或请求失败。编号与票面一致但渠道未接入时也是无法核验，不会判伪
qr_state	string	官方状态：合格、临期、逾期、不合格。没有查到时为空。逾期表示已过有效期，不表示证件是假的
qr_verify_msg	string	查验说明。例如「官方查验为合格」「官方查验为临期」「证明真实，当前已逾期」「未知健康证明」
ocr_ms	number	识别耗时（毫秒）
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "name": "张三",
    "gender": "女",
    "age": "28",
    "birth": "1998-01-01",
    "id_number": "11010119980101****",
    "industry": "公共场所",
    "exam_items": "细菌性痢疾:未检出;伤寒:未检出;病毒性肝炎(甲肝、戊肝):未检出;活动性肺结核:未检出;化脓性或渗出性皮肤病:无",
    "exam_result": "合格",
    "issued_by": "某某市卫生服务中心",
    "date_of_handling": "",
    "date_of_issue": "2020-06-01",
    "date_of_medical_examination": "",
    "valid_date": "2021-06-01",
    "cert_number": "(M)DEMO202006010001",
    "region": "tj",
    "qrcode": "https://example.com/health-check?markCode=(M)DEMO202006010001",
    "qr_verify": "真",
    "qr_state": "合格",
    "qr_verify_msg": "官方查验为合格",
    "ocr_ms": 1800
  },
  "request_id": "abc123",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

region（地区）

string

input_type

string

必填 · 图片传输方式：url（公网图片地址）或 base64 · 示例：url

input_data

string

必填 · 图片内容：url 时填 http/https 链接；base64 时填编码串（可含 data:image/xxx;base64, 前缀），≤10MB · 示例：https://example.com/health-cert.jpg

名称

类型

说明

Authorization

string

Content-Type

string

可选 · 请求体格式

名称

类型

说明

name

string

持证人姓名

gender

string

性别，男或女

age

string

年龄

birth

string

出生日期，YYYY-MM-DD。从证件号中已露出的出生日期读出，不补全掩码

id_number

string

证件号码。掩码星号按票面保留

industry

string

行业类别。查验为真时，以官方行业名称为准

exam_items

string

exam_result

string

体检结论。证件写明合格，且没有不合格项时为合格。查验为真时，官方状态为合格或临期写合格，不合格写不合格；逾期不改结论

issued_by

string

发证机关。查验为真时改为官方机构名称

date_of_handling

string

办证日期。天津电子证通常为空

date_of_issue

string

发证日期，YYYY-MM-DD。查验为真时以官方开始日期为准

date_of_medical_examination

string

体检日期。天津电子证通常为空

valid_date

string

有效期至，YYYY-MM-DD。查验为真时以官方截止日期为准

cert_number

string

编号，如 (M)DEMO202006010001。查验为真时以官方 markCode 为准

region

string

地区代码。天津市电子健康证明固定为 tj。其它地区不返回此字段

qrcode

string

证件二维码原文，通常是官方查验链接。识别不到时为空字符串

qr_verify

string

qr_state

string

官方状态：合格、临期、逾期、不合格。没有查到时为空。逾期表示已过有效期，不表示证件是假的

qr_verify_msg

string

查验说明。例如「官方查验为合格」「官方查验为临期」「证明真实，当前已逾期」「未知健康证明」

ocr_ms

number

识别耗时（毫秒）

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{ "code": 0, "msg": "成功", "data": { "name": "张三", "gender": "女", "age": "28", "birth": "1998-01-01", "id_number": "11010119980101****", "industry": "公共场所", "exam_items": "细菌性痢疾:未检出;伤寒:未检出;病毒性肝炎(甲肝、戊肝):未检出;活动性肺结核:未检出;化脓性或渗出性皮肤病:无", "exam_result": "合格", "issued_by": "某某市卫生服务中心", "date_of_handling": "", "date_of_issue": "2020-06-01", "date_of_medical_examination": "", "valid_date": "2021-06-01", "cert_number": "(M)DEMO202006010001", "region": "tj", "qrcode": "https://example.com/health-check?markCode=(M)DEMO202006010001", "qr_verify": "真", "qr_state": "合格", "qr_verify_msg": "官方查验为合格", "ocr_ms": 1800 }, "request_id": "abc123", "tips": "极数本源 · https://apizero.cn" }