Table of Contents

Créer une nouvelle cible d'image | POST /targets

Téléchargez une image de reconnaissance pour créer une nouvelle cible d'image

Action

POST /targets

Authentification

Requis

En-tête HTTP

Content-Type=application/json

En-tête HTTP : Authorization (lors de l'authentification par jeton de clé API)

Paramètres de requête

Champ Type Requis Description
image String(base64) Oui Chaîne encodée en base64 du contenu de l'image, formats JPG et PNG pris en charge. Taille maximale de l'image : 2 Mo.
active String Non "1" active la cible, "0" la désactive. Valeur par défaut : "1".
name String Oui Nom de la cible. Caractères acceptés : lettres anglaises, ponctuation anglaise, chiffres. Longueur : 1 à 64 caractères.
size String (Float) Oui Largeur de l'image de reconnaissance (en cm). La hauteur est calculée automatiquement. La taille correspond à celle du contenu virtuel. Valeur par défaut : 20.
meta String Oui Utilisé pour stocker des informations de contenu AR (format texte). Valeur par défaut : "". Exemples : JSON descriptif, image en base64 ou URL de fichier cloud. Taille maximale : 2 Mo.
type String Oui Doit être strictement "ImageTarget" (respecter la casse).
allowSimilar String Non Autoriser l'ajout malgré des images similaires (déconseillé). Valeur par défaut : 0.
Note
  • Taille maximale de image : 2 Mo
  • Taille maximale de meta : 2 Mo

Exemple de requête

    POST /targets/ HTTP/1.1
    Host:
    Date: Mon, 1 Jan 2018 00:00:00 GMT
    Content-Type: application/json
    {
        "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
        "active":"1",
        "name":"easyar",
        "size":"5",
        "meta":"496fbbabc2b38ecs3460a...",
        "type":"ImageTarget",
        "timestamp": 1514736000000,
        "appKey": "test_app_key",
        "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
    }

Exemple de réponse

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
        "statusCode": 0,
        "result": {
          "target": {
            "targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
            "trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."，
            "name": "easyar",
            "size": "5",
            "meta": "496fbbabc2b38ecs3460a...",
            "type": "ImageTarget",
            "modified":1514735000000,
            "active":"1"，
            "trackableRate": 0,
            "detectableRate": 0,
            "detectableDistinctiveness":0,
            "detectableFeatureCount":0,
            "trackableDistinctiveness":0,
            "trackableFeatureCount":0,
            "trackableFeatureDistribution":0,
            "trackablePatchContrast":0,
            "trackablePatchAmbiguity":0
          }
        },
        "timestamp": 1514736000000
    }

Champs de retour

Champ Description
statusCode Code d'état (0 = succès). Voir Codes d'état
result Message d'erreur ou informations de la cible
timestamp Horodatage Unix (millisecondes) du serveur
result.targetId ID unique de la cible
result.trackingImage Chaîne base64 de l'image de suivi
result.name Nom de la cible
result.size Largeur de l'image de reconnaissance (cm). Hauteur calculée automatiquement
result.meta Informations supplémentaires encodées en base64
result.type Toujours "ImageTarget"
result.active "1" = actif, "0" = inactif

Codes d'erreur

Voir Codes d'état et erreurs

Utilisation du champ Meta

  • Associer une URL vidéo
    • Stockez l'URL vidéo liée à une cible dans le champ meta
    • Après reconnaissance, l'application télécharge et lit la vidéo via cette URL (ex: https://my_server/my_videos/my_video_001.mp4)
  • Associer un modèle 3D
    • Stockez des modèles 3D ou des ressources Unity dans meta (encodés en base64 ou via URL)
    • Le modèle codé en base64 doit être stocké dans Meta ou l'URL du modèle dans les métadonnées
    • Lorsque la cible identifiée est appliquée, le modèle 3D est rendu sur la cible détectée