一、接口名称

往来港澳通行证OCR识别

二、接口介绍

可快速精准识别往来港澳通行证图片上的文字信息，返回包括姓名、证件号码、英文名、出生日期、性别、有效期限、签发地点、签发机关等字段信息。

三、API接口文档

1. 请求地址

url：https://api.shumaidata.com/v2/permit_to_hk/ocr

请求方式 method：post

参数：

2. 签名算法说明

服务商分配的appid、当前时间毫秒数timestamp、商户分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。

 如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc ;

 拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc ;

 加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;

3. 正确返回示例

{

    "msg": "成功",

    "success": true,

    "code": 200,

    "data": {

        "order_no": "fx4w2v6pc9i8m46mp6",

        "permitNumber": "CA****01",

        "permitType": "往来港澳通行证",

        "mrzCode": "CSC*****10<290**78<81***38<2",

        "sex": "女",

        "nameCn": "证件样本",

        "nameEn": "ZH****GBEN",

        "issueAuthority": "中华人民共和国出入境管理局",

        "birthDate": "1981.08.03",

        "validPeriod": "2019.01.18-2029.01.17",

        "issuePlace": "广东"

    }

}

4. 错误返回示例

{

    "msg": "入参错误",

    "success": false,

    "code": 400,

    "data": { }

}

5. 返回字段说明

6. result数组详解

7. Code错误码说明

四、适用场景

• 跨境与通关管理：口岸自助通关、海关/边检查验、内地酒店旅客登记。借助该接口可实现自动化核验，提升通行效率与准确性，落实治安管理。
• 实名制业务办理：银行开户与金融业务、电信营业厅开户、酒店/网吧入住登记。可替代手动录入，实现快速实名认证，防范业务风险。
• 政务与公共服务：公安/出入境证件管理、机场安检与值机、其他政府机构服务窗口。可快速完成采集归档，提高窗口处理效率，加强港澳人员管理。
• 其他通用信息处理：企业用户注册/实名认证、访客系统管理、合同/档案信息数字化；通过接口实现结构化提取信息，降低人工成本，避免输入错误，提升流程效率。

五、相关接口推荐

身份证OCR识别接口

护照OCR识别接口

通用文字OCR识别接口

更多API接口调用：https://www.shumaiapi.com/product