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