跳转到内容

哥伦比亚身份证OCR

身份证号码 + 姓名识别

代码示例:

curl --location --request POST 'https://api.ekycpro.com/v1/co_ocr/general' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-API-Key: AbcdEfgh' \
--data-urlencode 'img=BASE64_ENCODE_VALUE'

身份证背面识别成功的响应

{
"status": "OK",
"message": {
"CardNumber": "",
"GivenNames": "",
"Surname": "",
"DateOfExpiry": "",
"BloodType": "A+",
"DateOfBirth": "17-ENE-1987",
"DateOfIssue": "16-FEB-2005",
"Gender": "M",
"Height": "1.72",
"PlaceOfBirth": "BOGOTA D.C (CUNDINAMARCA)",
"PlaceOfIssue": "BOGOTA D.C."
}
}

身份证正面识别成功的响应

{
"status": "OK",
"message": {
"CardNumber": "1.136.879.353",
"GivenNames": "OSCAR FELIPE",
"Surname": "RUEDA PLATA",
"DateOfBirth": "19870117"
}
}

识别失败的响应

{
"status": "FAIL",
"message": "check input image and retry"
}

输入图像不是身份证的响应

{
"status": "FAIL",
"message": "not identity card"
}

无法识别的卡类型的响应

{
"status": "FAIL",
"message": "card not recognized"
}

无效请求参数的响应

{
"status": "INVALID_REQUEST",
"message": "check request params"
}

图像格式无效的响应

{
"status": "IMAGE_INVALID_FORMAT",
"message": "image format not support"
}

图像大小超过2M的响应

{
"status": "IMAGE_INVALID_SIZE",
"message": "image larger than 2M"
}

服务器错误的响应

{
"status": "INNER_ERROR",
"message": "Inner error, please retry later"
}

HTTP请求

POST https://api.ekycpro.com/v1/co_ocr/general

请求参数

参数描述
imgstring,Base64编码的图像。建议图像大小不超过200KB,以便在2秒内返回结果,否则返回时间会更长。

响应格式

字段描述
status状态码
messageCardNumber:身份证号码
GivenNames:名字
Surname:姓氏
Gender:性别
DateOfBirth:出生日期
DateOfExpiry:过期日期
PlaceOfBirth:出生地
DateOfIssue:签发日期
PlaceOfIssue:签发地
Height:身高
BloodType:血型

状态码

状态码描述
OKcharge,成功
FAILcharge,图像识别错误,请检查输入图像
INVALID_REQUESTfree,无效的请求参数
IMAGE_INVALID_FORMATfree,无效的图像格式,图像格式应为jpeg/jpg/png/bmp之一
IMAGE_INVALID_SIZEfree,图像大小无效,应小于2M
INNER_ERRORfree,服务器错误