Table of Contents

Classificação de dificuldade de reconhecimento de imagem | POST /grade/detection

Atribui uma pontuação de 0 a 4 baseada na dificuldade de reconhecimento da imagem, onde valores mais altos indicam maior dificuldade. -1 indica que a imagem não está em conformidade com as especificações, resultando em erro de reconhecimento (por exemplo, imagem corrompida ou papel em branco).

Melhores práticas recomendam chamar esta interface antes de criar novas imagens-alvo.

Grade Descrição
0 ou 1 Alvo facilmente detectável
2 Dificuldade média
3 ou 4 Alvo difícil de detectar

Ação

Dividido em três interfaces. Para buscas baseadas apenas em imagem, geralmente basta a classificação abrangente de reconhecibilidade.

  • POST /grade/detection

    • Fornece apenas o resultado abrangente de reconhecibilidade
  • POST /grade/tracking

    • Fornece apenas o resultado abrangente de rastreabilidade
  • POST /grade/detail

    • Fornece classificação algorítmica detalhada em múltiplas dimensões

Autenticação

Obrigatória

Cabeçalho HTTP

Content-Type=application/json

Cabeçalho HTTP: Authorization (quando usando autenticação via API Key Token)

Parâmetros de requisição

Campo Tipo Obrigatório Descrição
image String(base64) Sim String codificada em base64 do conteúdo da imagem. Formatos suportados: JPG e PNG. Tamanho máximo: 2MB.

Campos de retorno

Campo Descrição
statusCode Código de status. 0 indica autenticação válida. Consulte Códigos de status
result Mensagem de erro ou classificação (grade)
timestamp Horário do servidor no momento da resposta. Formato Unix timestamp em milissegundos
result.grade [-1, 0, 1, 2, 3, 4] onde 0-1 indicam reconhecimento fácil, 4 indica máxima dificuldade. -1 = imagem fora de conformidade.

Códigos de erro

Consulte Lista completa de códigos de status e erros

Exemplo de requisição

    POST /grade/detection/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

Exemplo de resposta

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
            "grade": 1
        },
        "timestamp": 1514736000000
    }