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