Pular para o conteúdo

OCR de KTP da Indonésia

Reconhecimento de KTP + nome

Exemplo de código:

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'

Resposta para reconhecimento bem-sucedido

{
"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"
}
}

Resposta para falha no reconhecimento

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

Resposta para parâmetros de solicitação inválidos

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

Resposta para formato de imagem inválido

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

Resposta para imagem maior que 2M

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

Resposta para erro do servidor

{
"status": "INNER_ERROR",
"message": "Serviço indisponível no momento, por favor tente novamente mais tarde"
}

Solicitação HTTP

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

Parâmetros da solicitação

parâmetrodescrição
imgstring, imagem codificada em base64. Recomenda-se que a imagem tenha menos de 200KB, para que seja retornada em até 2 segundos, caso contrário, o tempo de retorno será maior.

Formato da resposta

camposdescrição
statuscódigo de status
messageid: número do cartão de identificação, NIK
name: nome
pob: local de nascimento, pode estar vazio
dob: data de nascimento, pode estar vazio
gender: gênero, pode estar vazio
address: endereço, pode estar vazio
province: província, pode estar vazio
city: cidade, pode estar vazio
district: distrito, pode estar vazio
village: vila, pode estar vazio
rt: RT, pode estar vazio
rw: RW, pode estar vazio
religion: religião, pode estar vazio
marital_status: estado civil, pode estar vazio
work: trabalho, pode estar vazio
nationnality: nacionalidade, pode estar vazio

Código de status

statusdescrição
OKcharge, sucesso
FAILcharge, erro no reconhecimento da imagem, por favor verifique a imagem de entrada
INVALID_REQUESTfree, parâmetros de solicitação inválidos
IMAGE_INVALID_FORMATfree, formato de imagem inválido, o formato da imagem deve ser um dos seguintes: jpeg/jpg/png/bmp
IMAGE_INVALID_SIZEfree, tamanho de imagem inválido, deve ser menor que 2M
INNER_ERRORfree, erro do servidor