Modifier les propriétés d'image cible | PUT /target/<target_id>
Modifie les propriétés de l'image cible correspondant à target_id. Les paramètres sont modifiés sous forme HTTP patch, et les paramètres non modifiés restent inchangés.
Action
PUT /target/<target_id>
Authentification
Http Header
Content-Type=application/json
HTTP Header: Authorization (lorsque l'authentification API Key Token est utilisée)
Paramètres de requête
| Field | Type | Required | Description |
|---|---|---|---|
| image | String(base64) | Yes | Chaîne encodée en base64 du contenu de l'image. Les images aux formats JPG et PNG sont prises en charge. La taille maximale de l'image est de 2MB. |
| active | String | No | "1" pour activer la cible, "0" pour désactiver la cible. La valeur par défaut est "1". |
| name | String | Yes | Nom de la cible. Seules les lettres anglaises, la ponctuation anglaise et les chiffres sont pris en charge. Longueur minimale 1 caractère, longueur maximale 64 caractères. |
| size | String(Float) | Yes | Largeur de l'image de reconnaissance (unité: cm). La hauteur de l'image de reconnaissance est calculée automatiquement par le système selon l'image chargée. La taille de l'image de reconnaissance correspond à la taille du contenu virtuel. Valeur par défaut 20. |
| meta | String | Yes | Généralement utilisé pour stocker les informations de contenu AR au format chaîne de texte. La valeur par défaut est "". Par exemple: informations JSON de l'objet reconnu, encodage base64 d'une image, ou URL de téléchargement d'un fichier volumineux dans le stockage cloud. Maximum 2MB. |
| type | String (Float) | Yes | Doit être configuré de manière fixe comme la chaîne "ImageTarget". La casse doit être exactement identique. |
| allowSimilar | String | No | Indique si l'ajout forcé est autorisé lorsqu'il existe des images similaires. Valeur par défaut 0. Les images similaires peuvent affecter les résultats de reconnaissance; la valeur par défaut est donc recommandée. |
Note
- image est limité à 2MB maximum.
- meta est limité à 2MB maximum.
Exemple de requête
PUT /target/e61db301-e80f-4025-b822-9a00eb48d8d2 HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
"active":"1",
"name":"easyar",
"size":"5",
"meta":"496fbbabc2b38ecs3460a...",
"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",
"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
}
Champs de réponse
| Champ | Description |
|---|---|
| statusCode | Code d'état. 0 indique que l'authentification est correcte. Pour plus d'informations, consultez Codes d'état. |
| result | Message d'erreur ou informations sur l'image cible |
| timestamp | Heure côté serveur lors du retour de la réponse. Utilise le format Unix timestamp, en millisecondes |
| result.targetId | ID unique de l'image cible |
| result.trackingImage | Chaîne encodée en base64 de l'image de tracking |
| result.name | Nom de la cible |
| result.size | Largeur de l'image de reconnaissance (unité: cm). La hauteur de l'image de reconnaissance est calculée automatiquement par le système selon l'image chargée. La taille de l'image de reconnaissance correspond à la taille du contenu virtuel superposé |
| result.meta | Informations supplémentaires encodées en base64, par exemple une chaîne générée après encodage base64 d'une chaîne JSON |
| result.type | Fixé à ImageTarget |
| result.active | "1" activé, "0" désactivé |