哥伦比亚身份证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

请求参数

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

响应格式

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

状态码

状态码	描述
`OK`	`charge`，成功
`FAIL`	`charge`，图像识别错误，请检查输入图像
`INVALID_REQUEST`	`free`，无效的请求参数
`IMAGE_INVALID_FORMAT`	`free`，无效的图像格式，图像格式应为 jpeg/jpg/png/bmp 之一
`IMAGE_INVALID_SIZE`	`free`，图像大小无效，应小于 2M
`INNER_ERROR`	`free`，服务器错误