Table of Contents

Évaluation de la difficulté de recognizability d'image | POST /grade/detection

Attribue un score à la difficulté de recognition de l'image, de 0 à 4. Plus le score est élevé, plus la difficulté est grande. -1 indique une erreur de recognition causée par une image qui ne respecte pas les requirement, par exemple une image endommagée ou une feuille blanche.

La best practice consiste à appeler cette API avant de créer une nouvelle target image.

Grade Description
0 ou 1 Le target est facile à détecter
2 Moyen
3 ou 4 Le target est difficile à détecter

Action

Il existe trois API. En général, pour image search by image uniquement, seule l'évaluation complète de recognizability est nécessaire.

  • POST /grade/detection

    • Fournit uniquement le résultat complet de recognizability
  • POST /grade/tracking

    • Fournit uniquement le résultat complet de trackability
  • POST /grade/detail

    • Fournit des évaluations algorithmiques détaillées multidimensionnelles

Authentication

Requise

Http Header

Content-Type=application/json

HTTP Header: Authorization (lors de l'utilisation de authentication API Key Token)

Paramètres de request

Field Type Required Description
image String(base64) Yes Chaîne base64 encoded du contenu de l'image. Prend en charge les images JPG et PNG. Taille maximale de l'image : 2MB.

Champs de retour

Champ Description
statusCode Status code 0 indique que authentication est correcte. Pour plus d'informations, consultez Status code
result Message d'erreur, ou grade
timestamp Heure côté serveur lorsque la response est retournée. Utilise le format Unix timestamp, en millisecondes
result.grade [-1, 0, 1, 2, 3, 4], où 0 et 1 indiquent une recognition facile. 4 est le plus difficile à reconnaître. -1 indique que l'image ne respecte pas les requirement.

Error codes

Voir Status codes et error codes

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

Exemple de retour

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