主题
出生证明识别
接口描述
通过光学字符识别技术,从出生证明图像中识别出各项信息.
进行接口调用前,需要获取必要的token信息,可查看登录鉴权。 该接口为加密接口,可查看签名与加密方式配置加密秘钥,并对接口内容进行加密。
请求说明
HTTP 方法:
POST请求 URL:
/ai-cloud-face/ocr/v2/birthCertificateHeader如下:
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| img | 是 | String | 1-3000k | 待处理图片(base64 编码),原始图片大小需要小于 3M; |
| busFlowId | 否 | String | 0-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......",
"busFlowId":"uRVJfd594lRwz7m3"
}返回说明
返回参数:
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | String | 1-8 | 返回结果,00000000表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -flowId | String | 1-64 | 交易流水ID(建议保存) |
| -busFlowId | String | 0-64 | 业务流水号,业务系统唯一序列号 |
| -babyBirthday | String | 1-32 | 出生日期 |
| -birthProvince | String | 1-32 | 出生地点_省 |
| -birthCity | String | 1-32 | 出生地点_市 |
| -birthCounty | String | 1-32 | 出生地点_县(区) |
| -birthWeight | String | 1-32 | 出生体重 |
| -birthLength | String | 1-32 | 出生身长 |
| -gestationalAge | String | 1-32 | 出生孕周 |
| -babyName | String | 1-32 | 幼儿姓名 |
| -babySex | String | 1-32 | 幼儿性别 |
| -code | String | 1-64 | 出生证编号 |
| -hospital | String | 1-64 | 出生医院/医疗机构名称 |
| -fatherName | String | 1-64 | 父亲姓名 |
| -fatherID | String | 1-32 | 父亲身份证号 |
| -fatherNationality | String | 1-32 | 父亲国籍 |
| -fatherEthnic | String | 1-32 | 父亲民族 |
| -fatherAddress | String | 1-64 | 父亲住址 |
| -fatherAge | String | 1-32 | 父亲年龄 |
| -motherName | String | 1-64 | 母亲姓名 |
| -motherID | String | 1-32 | 母亲身份证号 |
| -motherNationality | String | 1-32 | 母亲国籍 |
| -motherEthnic | String | 1-32 | 母亲民族 |
| -motherAddress | String | 1-64 | 母亲住址 |
| -motherAge | String | 1-32 | 母亲年龄 |
返回示例:
{
"code": "00000000",
"message": "请求成功",
"data": {
"flowId": "1234567890abcdef1234567890abcdef",
"busFlowId": "BUS1234567890",
"babyBirthday": "2026-01-01",
"birthProvince": "浙江省",
"birthCity": "杭州市",
"birthCounty": "西湖区",
"birthWeight": "3.2",
"birthLength": "50",
"gestationalAge": "40",
"babyName": "小明",
"babySex": "男",
"code": "出生证1234567890",
"hospital": "杭州市第一人民医院",
"fatherName": "张三",
"fatherID": "500234************",
"fatherNationality": "中国",
"fatherEthnic": "汉族",
"fatherAddress": "杭州市西湖区文三路123号",
"fatherAge": "28",
"motherName": "李四",
"motherID": "500234************",
"motherNationality": "中国",
"motherEthnic": "汉族",
"motherAddress": "杭州市西湖区文三路123号",
"motherAge": "26"
}
}错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 成功 |
| 50028100 | 否 | 否 | 图片不能为空 |
| 50028103 | 否 | 否 | 图片大小不能超过3M |
| 50028104 | 否 | 否 | 图片Base64编码错误或图片原始数据错误 |
| 50028205 | 否 | 否 | 出生证明识别异常 |