Comparação de Cartão de Identidade Segurado

Analise a possibilidade de a pessoa segurando o cartão de identidade e a foto do cartão de identidade pertencerem à mesma pessoa. Usando nossa tecnologia de correspondência facial, você obterá nosso julgamento sobre se é a mesma pessoa, bem como uma pontuação de similaridade.

Exemplo de código:

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

Exemplo de resposta para a mesma pessoa

{
  "status": "OK",
  "message": {
    "similarity": 97.501,
    "result": "SAME PERSON"
  }
}

Exemplo de resposta para não a mesma pessoa

{
  "status": "OK",
  "message": {
    "similarity": 27.501,
    "result": "NOT SAME PERSON"
  }
}

Exemplo de resposta para solicitação com erro

{
  "status": "INVALID_REQUEST",
  "message": "error message"
}

Exemplo de resposta para imagem carregada maior que 2M

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

Exemplo de resposta para imagem errada, não é uma imagem de cartão de identidade segurado

{
  "status": "RETRY_LATER",
  "message": "error not idholding image"
}

Resposta para erro do servidor

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

Solicitação HTTP

POST https://api.ekycpro.com/v1/idholding

Parâmetros da solicitação

parâmetro	descrição
img	string, imagem codificada em base64

Formato da resposta

campos	descrição
status	código de status
message	similarity: pontuação de similaridade, 0~100 result: julgamento

Código de status

status	descrição
OK	charge, sucesso, message.similarity contém a pontuação de similaridade
RETRY_LATER	charge, imagem de cartão de identidade segurado inválida
INVALID_REQUEST	free, parâmetros de solicitação inválidos
IMAGE_INVALID_SIZE	free, tamanho da imagem maior que 2M
INNER_ERROR	free, erro do servidor