往来港澳通行证OCR识别

接口标识: exitentryocr 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

往来港澳通行证OCR识别接口上传证件照片，一次返回 11 个结构化字段：中英文姓名、性别、出生日期、通行证号码、通行证类型、签发日期、有效期至、签发地点、签发机关与卡片底部的机读码。通行证类型同时覆盖往来港澳通行证与大陆居民往来台湾通行证，出生日期、签发日期与有效期至三项均按 YYYY-MM-DD 格式返回，适合出入境材料收取与旅行社收客登记。

详细介绍

![往来港澳通行证OCR识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_exitentryocr__1794169320_a4f8336aa11b.png)

出入境业务、旅行社收客要登记通行证信息，还在逐字手敲证件号？上传一张往来港澳通行证照片，姓名、通行证号码、签发日期、有效期至等关键信息即自动变成结构化字段，直接落入你的业务系统。

## 接口概述

往来港澳通行证OCR识别接口面向出入境材料收取、旅行社报名登记、政务预审、企业差旅备案等场景：传入一张往来港澳通行证卡片照片（公网URL、Base64 或平台文件ID），由阿里云百炼视觉大模型（默认 qwen3.5-ocr，平台可在后台切换）完成整卡读取，同步返回姓名、英文姓名、性别、出生日期、通行证号码、通行证类型、签发日期、有效期至、签发地点、签发机关、机读码共 11 个字段。响应按固定字段清单构造：未识别到的字段统一返回空字符串，不会出现 null；出生日期、签发日期、有效期至自动标准化为 YYYY-MM-DD。

## 核心能力

1. **整卡结构化提取**：中英文姓名、证件号、签发与有效期信息、机读码一次读全，共 11 个字段，免去人工录入。
2. **固定字段契约**：响应始终返回全部字段，未识别到的为空字符串，不会缺键、不会返回 null，解析与入库无需防御性判断。
3. **日期自动规范**：出生日期、签发日期、有效期至统一转为 YYYY-MM-DD，自动兼容「2026.02.02」「2026年02月02日」等写法；模型偶尔把两个日期合并返回时自动拆分；无法识别时保留卡面原文。
4. **机读码同步返回**：卡片底部机读区代码一并提取（mrzCode），可用于二次校验或存档。
5. **图片输入灵活**：公网URL、Base64、文件ID三种方式任选，旋转、侧拍的证件照可自动方向适配。

## 产品优势

- **接入简单**：仅 `file` 一个业务参数，POST 请求即返 JSON，无需自建识别引擎与维护模板。
- **稳定可靠**：响应字段与文档约定一致，识别不到时返回空字符串而非报错，集成侧逻辑简单。

## 效果展示

一句话理解：它就像请了一位熟练的口岸登记员，把整张通行证「念」成一张标准表格——中英文姓名、证件号、有效期，一个字段都不落。

以一次典型调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/permit.jpg | 往来港澳通行证照片的公网URL，也支持 Base64（data:开头）或文件ID（fileid_开头） |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 姓名 | 张晓明 | `name` |
| 英文姓名 | ZHANG XIAOMING | `eNname` |
| 通行证号码 | `"CK1234567"` | `permit_number` |
| 通行证类型 | 往来港澳通行证 | `permit_type` |
| 出生日期 | 1990-03-11 | `date_of_birth`，已标准化为 YYYY-MM-DD |
| 签发日期 | 2026-02-02 | `date_of_issue`，已标准化为 YYYY-MM-DD |
| 有效期至 | 2036-02-01 | `date_of_expiry`，已标准化为 YYYY-MM-DD |
| 签发机关 | 中华人民共和国出入境管理局 | `issueAuthority` |

API请求示例：

```
POST /api/v1/exitentryocr
file=https://example.com/demo/permit.jpg
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "name": "张晓明",
    "eNname": "ZHANG XIAOMING",
    "sex": "男",
    "date_of_birth": "1990-03-11",
    "permit_number": "CK1234567",
    "permit_type": "往来港澳通行证",
    "date_of_issue": "2026-02-02",
    "date_of_expiry": "2036-02-01",
    "issuePlace": "河南",
    "issueAuthority": "中华人民共和国出入境管理局",
    "mrzCode": "CK1234567<8CHN9003117M3602016<<<<<<<<<<<<<<08"
  }
}
```

一次调用即完成整卡读取：表格与示例值一一对应；`permit_number`、`mrzCode` 等字段均以字符串返回，入库前无需做类型转换。

## 应用场景

- **旅行社收客系统**：港澳游报名时读取通行证号码与有效期，自动校验是否临近过期。
- **出入境材料预审**：提取签发机关、签发地点等要素，异常件转人工复核。
- **企业差旅备案**：员工证件信息自动登记，减少行政手工录入。
- **证件档案管理**：纸质证件照片批量转结构化数据，便于检索与到期提醒。
- **在线表单自动填充**：用户上传证件照即回填姓名与证件号，降低填写错误。

## 应用案例

- **旅行社港澳游报名系统**：客服原先逐字抄录通行证信息并人工核对有效期，接入后拍照上传即自动回填报名表并提示临期证件，单客登记耗时大幅压缩，因证件过期导致的出行纠纷明显减少。
- **政务出入境预审平台**：群众上传通行证照片，系统自动比对签发机关与有效期要素，材料不齐或临期的当场提示补正，窗口二次跑动率显著下降。
- **大型企业差旅管理系统**：员工备案证件时拍照上传，证件号与有效期自动入库并按到期时间推送续签提醒，行政台账维护成本明显降低。

常见问题

Q：往来港澳通行证OCR识别接口能做什么？

A：对往来港澳通行证卡片图片做结构化识别，提取姓名、英文姓名、性别、出生日期、通行证号码、通行证类型、签发日期、有效期至、签发地点、签发机关、机读码共11个字段。同步接口，调用后直接返回结果。

Q：支持什么格式的文件输入？

A：file 参数可传公网图片URL、data: 开头的 Base64 字符串或 fileid_ 开头的文件ID，平台自动检测类型。支持 JPG、PNG、BMP、GIF、WEBP、TIFF 等常见图片格式；Word、Excel、PPT 等办公文档不支持，会返回参数错误。

Q：识别不到的字段会怎样？

A：响应按固定字段清单构造，11个字段始终全部返回，未识别到的字段为空字符串，不会出现 null。识别由大模型完成，无法承诺百分之百准确，建议对通行证号码、有效期等关键字段做非空校验并辅以人工复核。

Q：日期字段的格式统一吗？

A：出生日期、签发日期、有效期至统一标准化为 YYYY-MM-DD，自动兼容「2026.02.02」「2026年02月02日」等写法；模型偶尔将两个日期合并返回时会自动拆分；无法识别时保留卡面原文，因此不保证全部取值都是该格式。

港澳通行证识别出入境证件通行证录入机读码旅行收客证件OCR

接口地址： https://www.phpwc.cn/api/exitentryocr

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`name`	string	姓名
`eNname`	string	英文姓名，如：ZHANG SAN
`sex`	string	性别
`date_of_birth`	string	出生日期，格式YYYY-MM-DD
`permit_number`	string	通行证号码
`permit_type`	string	通行证类型（往来港澳通行证/大陆居民往来台湾通行证）
`date_of_issue`	string	签发日期，格式YYYY-MM-DD
`date_of_expiry`	string	有效期至，格式YYYY-MM-DD
`issuePlace`	string	签发地点，如：广东
`issueAuthority`	string	签发机关，如：中华人民共和国出入境管理局
`mrzCode`	string	机读码，卡片底部的机读区代码
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试