Modificar propiedades de imagen de destino | PUT /target/<target_id>
Modifica las propiedades de la imagen de destino correspondiente a target_id. Utiliza Http patch para modificar parámetros, manteniendo sin cambios los parámetros no modificados.
Action
PUT /target/<target_id>
Autenticación
Cabecera HTTP
Content-Type=application/json
HTTP Header: Authorization (cuando se utiliza autenticación por API Key Token)
Parámetros de solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| image | String(base64) | Sí | Cadena codificada en base64 del contenido de la imagen, admite formatos JPG y PNG. Tamaño máximo de imagen: 2MB. |
| active | String | No | "1" para activar el objetivo, "0" para desactivarlo. Por defecto "1". |
| name | String | Sí | Nombre del objetivo, solo admite letras inglesas, puntuación inglesa, números. Longitud mínima: 1 carácter, máxima: 64 caracteres. |
| size | String (Float) | Sí | Ancho de la imagen de reconocimiento (en cm). La altura se calculará automáticamente según la imagen subida. El tamaño de la imagen de reconocimiento corresponde al tamaño del contenido virtual. Por defecto 20. |
| meta | String | Sí | Normalmente se usa para almacenar información de contenido AR, formato de cadena de texto, por defecto "". Ejemplo: información JSON del objeto reconocido, codificación base64 de imagen, o URL de descarga de archivos grandes en almacenamiento en nube. Máximo 2MB. |
| type | String (Float) | Sí | Debe configurarse como la cadena "ImageTarget", notar que las mayúsculas/minúsculas deben coincidir exactamente. |
| allowSimilar | String | No | Si existen imágenes similares, permite forzar la adición. Por defecto 0. Las imágenes similares pueden afectar el reconocimiento, se recomienda usar el valor por defecto. |
Nota
- image tiene un límite máximo de 2MB.
- meta tiene un límite máximo de 2MB.
Ejemplo de solicitud
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"
}
Ejemplo de respuesta
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
}
Campos de respuesta
| Campo | Descripción |
|---|---|
| statusCode | Código de estado 0 indica autenticación correcta. Más referencias en códigos de estado |
| result | Mensaje de error o información de la imagen objetivo |
| timestamp | Hora del servidor al momento de la respuesta. Formato Unix timestamp en milisegundos |
| result.targetId | ID único de la imagen objetivo |
| result.trackingImage | Cadena base64 de la imagen de seguimiento |
| result.name | Nombre del objetivo |
| result.size | Ancho de la imagen de reconocimiento (en cm). La altura se calcula automáticamente según la imagen subida. El tamaño corresponde al contenido virtual superpuesto |
| result.meta | Información adicional codificada en base64, ej: cadena JSON codificada en base64 |
| result.type | Fijado como ImageTarget |
| result.active | "1" activado, "0" desactivado |