Ähnliches zielbild vorhanden | POST /similar

Überprüft, ob im Zielbilderkatalog bereits ähnliche Bilder zum Zielbild vorhanden sind. Es wird empfohlen, diesen Endpunkt zu nutzen, bevor ein neues Zielbild erstellt wird.

Action

POST /similar

Authentifizierung

Erforderlich

HTTP Header

Content-Type=application/json

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

Anfrageparameter

Feld	Typ	Erforderlich	Beschreibung
image	String(base64)	Ja	Base64-kodierter String des Bildinhalts. Unterstützt JPG- und PNG-Bilder.

Rückgabefelder

Feld	Beschreibung
statusCode	Statuscode. 0 zeigt eine erfolgreiche Authentifizierung an. Weitere Codes siehe Statuscodes
result	Fehlermeldung oder Ergebnis: Array ähnlicher Zielbilder. Ein leeres Array bedeutet, dass keine ähnlichen Bilder existieren.
timestamp	Serverzeitpunkt der Antwort. Unix-Zeitstempelformat in Millisekunden.

Fehlercodes

Siehe Status- und Fehlercodes

Anfragebeispiel

    POST /similar/ 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": {
            "date": "2016-06-15T09:58:51.000Z",
            "results":[
                {
                    "targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
                    "trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
                    "name": "easyar",
                    "size": "5",
                    "meta": "496fbbabc2b38ecs3460a...",
                    "type": "ImageTarget",
                    "date": "2016-06-15T09:56:30.000Z",
                    "active":"1",
                    "trackableRate": 0,
                    "detectableRate": 0,
                    "detectableDistinctiveness":0,
                    "detectableFeatureCount": 0,
                    "trackableDistinctiveness": 0,
                    "trackableFeatureCount": 0,
                    "trackableFeatureDistribution": 0,
                    "trackablePatchContrast": 0,
                    "trackablePatchAmbiguity": 0
                }
            ]
        },
        "timestamp": 1514736000000
    }