印度尼西亚身份证OCR

KTP + 名称识别

代码示例：

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

识别成功的响应

{
  "status": "OK",
  "message": {
    "name": "HELLO NAME",
    "id": "3171024302821001",
    "pob": "GARESSI SUPPA",
    "dob": "01-01-1961",
    "gender": "LAKI-LAKI",
    "address": "BTN UNHALU BLOK C NO. 28",
    "rt": "006",
    "rw": "003",
    "village": "KAMBU",
    "district": "KAMBU",
    "religion": "ISLAM",
    "marital_status": "KAWIN",
    "work": "PEGAWAI NEGERI SIPIL (PNS)",
    "nationnality": "WNI",
    "city": "KOTA KENDARI",
    "province": "SULAWESI TENGGARA"
  }
}

识别失败的响应

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

无效请求参数的响应

{
  "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": "Service is not available right now, please try again later"
}

HTTP 请求

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

请求参数

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

响应格式

字段	描述
status	状态码
message	id：身份证号码，NIK name：姓名 pob：出生地，可能为空 dob：出生日期，可能为空 gender：性别，可能为空 address：地址，可能为空 province：省份，可能为空 city：城市，可能为空 district：区，可能为空 village：村庄，可能为空 rt：RT，可能为空 rw：RW，可能为空 religion：宗教，可能为空 marital_status：婚姻状况，可能为空 work：工作，可能为空 nationnality：国籍，可能为空

状态码

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