Detecção de Vivacidade

Existem 2 etapas para o Serviço de Detecção de Vivacidade.

Etapa 1: Integrar o SDK para Android
Etapa 2: Solicitar Detecção de Vivacidade para obter a pontuação de vivacidade

1 Integrar o SDK

Para Android

2 Detecção de Vivacidade V1

Exemplo de Código:

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

Exemplo de Resposta de Sucesso:

{
  "status": "OK",
  "message": {
    "live_score": 100
  }
}

Exemplo de resposta de sucesso (detail = 1):

{
  "status": "OK",
  "message": {
    "is_liveness": true,
    "live_score": 100,
    "reason": "success"
  }
}

Exemplo de múltiplos rostos (detail = 1):

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "multiple faces"
  }
}

Exemplo de rosto sem vivacidade (detail = 1):

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "no liveness face"
  }
}

Exemplo de olhos fechados (detail = 1):

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "eyes closed"
  }
}

Exemplo de insatisfação com a idade (detail = 1):

{
  "status": "OK",
  "message": {
    "is_liveness": false,
    "live_score": 0,
    "reason": "age dissatisfaction"
  }
}

Exemplo de Resposta de Erro de Imagem:

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

Exemplo de Resposta de Erro de Parâmetro de Solicitação:

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

Exemplo de Resposta de Erro de Formato de Imagem:

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

Exemplo de Resposta de Erro de Imagem Maior que 2M:

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

Exemplo de Resposta de Erro do Servidor:

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

URL de Solicitação

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

Parâmetros de Solicitação:

Parâmetro	Descrição
`img`	`string`, imagem codificada em Base64, a foto do vídeo ao vivo
`country`	`string`, Abreviação do país. México: MX, Índia: IN, Tailândia:TH , Indonésia:ID
`detail`	`opcional`,`string`, quando detail=1 retorna o motivo da reprovação.

Descrição da Resposta Padrão:

Parâmetro	Descrição
`status`	código de status
`message`	`live_score`：Pontuação de Detecção de Vivacidade [0-100]

Descrição da Resposta Detalhada

parâmetro	descrição
`status`	código de status
`message`	`is_liveness`：se a detecção de vivacidade foi aprovada `live_score`：pontuação de vivacidade [0-100] `reason`：success、eyes closed、no liveness face、face incomplete、face dark、face blur、no face detected、multiple faces

Código de Status:

Status	Mensagem
`OK`	`charge`，Reconhecimento bem-sucedido
`FAIL`	`charge`，Erro de imagem
`INVALID_REQUEST`	`free`，Parâmetro de solicitação incorreto
`IMAGE_INVALID_FORMAT`	`free`，Formato de imagem não suportado, apenas PNG, JPG, JPEG, BMP são suportados
`IMAGE_INVALID_SIZE`	`free`，O tamanho da imagem deve ser menor que 2M após a codificação base64
`INNER_ERROR`	`free`，Erro do sistema