Difficoltà di riconoscibilità dell'immagine | POST /grade/detection

Assegna un punteggio alla difficoltà di riconoscimento dell'immagine su una scala da 0 a 4, dove un punteggio più alto indica una maggiore difficoltà. -1 indica un errore di riconoscimento dovuto a un'immagine non conforme (danneggiata o foglio bianco, ecc.).

La best practice consiste nel richiamare questa interfaccia prima di creare una nuova immagine target.

Grado	Descrizione
0 o 1	Il target è facilmente rilevabile
2	Difficoltà media
3 o 4	Il target è difficile da rilevare

Action

Divisa in tre interfacce; per la sola ricerca di immagini basata su immagine, è sufficiente la valutazione complessiva della riconoscibilità.

POST /grade/detection
- Fornisce solo il risultato complessivo sulla riconoscibilità.
POST /grade/tracking
- Fornisce solo il risultato complessivo sulla tracciabilità.
POST /grade/detail
- Fornisce una valutazione algoritmica dettagliata multidimensionale.

Autenticazione

Richiesta

Http Header

Content-Type=application/json

HTTP Header: Authorization (quando si utilizza l'autenticazione tramite token API Key)

Parametri della richiesta

Campo	Tipo	Obbligatorio	Descrizione
image	String(base64)	Sì	Stringa codificata in base64 del contenuto dell'immagine. Supporta immagini in formato JPG e PNG. Dimensioni massime dell'immagine: 2MB.

Campi di risposta

Campo	Descrizione
statusCode	Codice di stato 0 indica autenticazione corretta, per maggiori dettagli vedere Codici di stato
result	Messaggio di errore, o grado
timestamp	Timestamp del lato server al momento della risposta. Formato timestamp Unix, in millisecondi
result.grade	[-1, 0, 1, 2, 3, 4] dove 0 e 1 indicano facile riconoscimento. 4 indica la massima difficoltà. -1 indica un'immagine non conforme.

Codici di errore

Vedere Lista completa dei codici di stato e degli errori

Esempio di richiesta

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

Esempio di risposta

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

Table of Contents