Schwierigkeitsgrad der Bilderkennung | POST /grade/detection

Bewertet den Schwierigkeitsgrad der Bilderkennung auf einer Skala von 0 bis 4, wobei ein höherer Wert größere Schwierigkeiten bedeutet. -1 zeigt an, dass das Bild nicht den Spezifikationen entspricht und nicht erkannt werden konnte (z. B. beschädigt oder leeres Blatt).

Bewährte Praxis: Dieser Endpunkt sollte vor dem Erstellen neuer Zielbilder aufgerufen werden.

Grade	Beschreibung
0 oder 1	Ziel leicht erkennbar
2	Mittelmäßig
3 oder 4	Ziel schwer erkennbar

Action

Drei Endpunkte verfügbar. Für reine Bildersuche mit Bild ist nur die Gesamtbewertung der Erkennbarkeit relevant.

POST /grade/detection
- Gibt nur das Gesamtergebnis für die Erkennbarkeit zurück
POST /grade/tracking
- Gibt nur das Gesamtergebnis für die Verfolgbarkeit zurück
POST /grade/detail
- Gibt eine detaillierte algorithmische Bewertung in mehreren Dimensionen zurück

Authentifizierung

Erforderlich

HTTP Header

Content-Type=application/json

HTTP-Header: Authorization (bei Authentifizierung mit API-Key-Token)

Anfrageparameter

Feld	Typ	Erforderlich	Beschreibung
image	String(base64)	Ja	Base64-kodierter String des Bildinhalts. Unterstützt JPG- und PNG-Formate. Maximale Bildgröße 2 MB.

Rückgabefelder

Feld	Beschreibung
statusCode	Statuscode. 0 bedeutet erfolgreiche Authentifizierung. Weitere Informationen unter Statuscodes
result	Fehlermeldung oder Bewertung (grade)
timestamp	Serverzeitpunkt der Antwort. Im Unix-Zeitstempel-Format, in Millisekunden
result.grade	[-1, 0, 1, 2, 3, 4]. 0 und 1 bedeuten leicht erkennbar. 4 ist am schwierigsten. -1 bedeutet, dass das Bild nicht den Spezifikationen entspricht.

Fehlercodes

Siehe Status- und Fehlercodes – Übersicht

Anfragebeispiel

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

Antwortbeispiel

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

Table of Contents