稳定、快速的API服务

户口本识别,我们致力于为用户提供专业的免费API数据接口服务

户口本识别 v1.0

最后更新: 2026-09-02 12:12:08

户口本OCR识别接口,精准识别户口本上的相关户籍证明信息,可自动区分户主页和常住人口登记页。

按次计费(¥0.10/次) 调用次数: 0 正常运行 响应速度: <100ms 需要传入API密钥

接口信息

接口地址:
https://api.shuliancloud.com/v4/recognize_household/ocr
请求方式: POST
返回格式: JSON

调用统计

0
今日调用
0
总调用次数
请求示例 https://api.shuliancloud.com/v4/recognize_household/ocr

点击右侧按钮复制完整请求地址,参数值请替换为实际有效值

请求参数 (暂无请求参数)

参数名 是否必填 参数类型 参数说明
暂无请求参数信息

请求参数说明

|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名,<a href='#sign'>签名算法说明</a>  |
|image| varchar| 否 | 图片base64串,image、url二选一
| url | varchar | 否 | 图片url,image、url二选一|
|isResidentPage|boolean|否|是否是户口本常住人口页,默认为否(false)。|

返回参数 (暂无返回参数)

参数名 参数类型 参数说明
暂无返回参数信息

返回参数说明

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识,true为成功,false为失败,失败情况下,会有对应描述和状态码  |   
| code  |成功为200,其它为失败状态码   | 
| msg  | code对应的说明描述   | 
| data  | 验证结果详细信息|  
| order_no  | 订单号|


#### 结构化信息(户主页_**data**_字段,当 **IsResidentPage** 不传或传 false。)

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| Registrar | string | 承办人签章。 |
| address | string | 住址。 |
| householdNumber | string | 户号。 |
| householdType | string | 户别。 |
| householderCommunity | string | 户主社区。 |
| householderName | string | 户主姓名。 |
| issueDate | string | 签发日期。 |
| sectionNo | string | 地段号。 |

#### 结构化信息(常住人口页_**data**_字段,当**IsResidentPage=true**。)

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| birthDate | string | 出生日期。 |
| birthPlace | string | 出生地。 |
| bloodGroup | string | 血型。 |
| educationalDegree | string | 文化程度。 |
| employer | string | 服务处所。 |
| ethnicity | string | 民族。 |
| formerName | string | 曾用名。 |
| householdNumber | string | 户号。 |
| idCardNumber | string | 身份证编号。 |
| immigratedToCityInfo | string | 何时何地迁来本市。 |
| immigratedToResidenceInfo | string | 何时由何地迁来本址。 |
| maritalStatus | string | 婚姻状况。 |
| militaryServiceStatus | string | 兵役状况。 |
| name | string | 姓名。 |
| nativePlace | string | 籍贯。 |
| occupation | string | 职业。 |
| otherResidence | string | 本市其他住址。 |
| registrar | string | 承办人签章。 |
| registrationDate | string | 登记日期。 |
| relation | string | 与户主关系。 |
| religious | string | 宗教信仰。 |
| sex | string | 性别。 |
| stature | string | 身高。 |

返回示例

{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "order_no": "blpwgxxgwwyc345oa2",
        "religious": "",
        "immigratedToCityInfo": "文居",
        "occupation": "000",
        "ethnicity": "汉",
        "registrar": "",
        "educationalDegree": "*学",
        "sex": "女性",
        "militaryServiceStatus": "",
        "householdNumber": "558113**",
        "birthDate": "****年9月16日",
        "relation": "户主",
        "birthPlace": "原庆市**县",
        "bloodGroup": "",
        "immigratedToResidenceInfo": "****年7月23日由重庆市云***",
        "name": "付*",
        "idCardNumber": "500235****09166943",
        "stature": "",
        "registrationDate": "",
        "nativePlace": "重庆市**县",
        "otherResidence": "",
        "employer": "集体经济组织",
        "formerName": "",
        "maritalStatus": ""
    }
}