Table of Contents

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

Atribui pontuação à dificuldade de recognition da imagem de 0 a 4 em ordem. Quanto maior o valor, maior a dificuldade. -1 indica um recognition error causado por uma imagem que não atende aos requirement, como imagem danificada ou papel branco.

A best practice é chamar esta API antes de criar uma nova target image.

Grade Descrição
0 ou 1 Target fácil de detectar
2 Médio
3 ou 4 Target difícil de detectar

Action

Há três APIs. Em geral, para image search by image, é necessária apenas a classificação abrangente de recognizability.

  • POST /grade/detection

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

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

    • Fornece classificações detalhadas multidimensionais do algoritmo

Authentication

Necessária

Http Header

Content-Type=application/json

HTTP Header: Authorization (ao usar authentication API Key Token)

Parâmetros da request

Field Type Required Description
image String(base64) Yes String base64 encoded do conteúdo da imagem. Suporta imagens JPG e PNG. Tamanho máximo da imagem 2MB.

Campos de retorno

Campo Descrição
statusCode Status code 0 indica que authentication está correta. Para mais, consulte Status code
result Mensagem de erro, ou grade
timestamp Horário do servidor quando a response é retornada. Usa formato Unix timestamp, em milissegundos
result.grade [-1, 0, 1, 2, 3, 4], em que 0 e 1 indicam recognition fácil. 4 é o mais difícil de reconhecer. -1 indica que a imagem não atende aos requirement.

Error codes

Consulte Status codes and error codes

Exemplo de request

    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 retorno

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