Schwierigkeitsbewertung der Bild-recognizability | POST /grade/detection

Bewertet die Schwierigkeit der image recognition nacheinander von 0 bis 4. Je größer der Wert, desto höher die Schwierigkeit. -1 steht für einen recognition error, der dadurch verursacht wird, dass das Bild die requirements nicht erfüllt, etwa ein beschädigtes Bild oder weißes Papier.

Best practice ist, diese API aufzurufen, bevor ein neues target image erstellt wird.

Grade	Beschreibung
0 oder 1	Target ist leicht zu erkennen
2	Durchschnittlich
3 oder 4	Target ist schwer zu erkennen

Action

Es gibt drei APIs. Im Allgemeinen wird für image search by image nur die umfassende Bewertung der recognizability benötigt.

POST /grade/detection
- Liefert nur das umfassende Ergebnis für recognizability
POST /grade/tracking
- Liefert nur das umfassende Ergebnis für trackability
POST /grade/detail
- Liefert mehrdimensionale detaillierte Algorithmusbewertungen

Authentication

Erforderlich

Http Header

Content-Type=application/json

HTTP Header: Authorization (bei Verwendung von API Key Token authentication)

request-Parameter

Field	Type	Required	Description
image	String(base64)	Yes	Base64 encoded string des Bildinhalts. Unterstützt JPG- und PNG-Bilder. Maximale Bildgröße 2MB.

Rückgabefelder

Feld	Beschreibung
statusCode	Status code 0 bedeutet, dass authentication korrekt ist. Weitere Informationen unter Status codes
result	Fehlermeldung oder grade
timestamp	Serverzeit beim Zurückgeben der response. Verwendet Unix timestamp-Format in Millisekunden
result.grade	[-1, 0, 1, 2, 3, 4], wobei 0 und 1 leichtes recognition bedeuten. 4 ist am schwierigsten zu erkennen. -1 bedeutet, dass das Bild die requirements nicht erfüllt.

Error codes

Siehe Status codes and error codes

request-Beispiel

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

Rückgabebeispiel

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

Table of Contents