Modificar propiedades de imagen objetivo | PUT /target/<target_id>

Modifica las propiedades de la imagen objetivo correspondiente a target_id. Los parámetros se modifican en forma de HTTP patch, y los parámetros sin cambios permanecen sin cambios.

Action

PUT /target/<target_id>

Autenticación

Requerida

Http Header

Content-Type=application/json

HTTP Header: Authorization (cuando se usa autenticación API Key Token)

Parámetros de solicitud

Field	Type	Required	Description
image	String(base64)	Yes	Cadena codificada en base64 del contenido de la imagen. Se admiten imágenes en formato JPG y PNG. El tamaño máximo de imagen es 2MB.
active	String	No	"1" para habilitar el objetivo, "0" para deshabilitar el objetivo. El valor predeterminado es "1".
name	String	Yes	Nombre del objetivo. Solo se admiten letras inglesas, signos de puntuación ingleses y números. Longitud mínima 1 carácter, máxima 64 caracteres.
size	String(Float)	Yes	Ancho de la imagen de reconocimiento (unidad: cm). La altura de la imagen de reconocimiento será calculada automáticamente por el sistema según la imagen cargada. El tamaño de la imagen de reconocimiento corresponde al tamaño del contenido virtual. Predeterminado 20.
meta	String	Yes	Generalmente se usa para almacenar información de contenido AR en formato de cadena de texto. El valor predeterminado es "". Por ejemplo: información JSON del objeto reconocido, codificación base64 de una imagen o URL de descarga de un archivo grande en almacenamiento en la nube. Máximo 2MB.
type	String (Float)	Yes	Debe configurarse de forma fija como la cadena "ImageTarget". La distinción entre mayúsculas y minúsculas debe ser exactamente igual.
allowSimilar	String	No	Si se permite forzar la adición cuando existen imágenes similares. Predeterminado 0. Las imágenes similares pueden afectar los resultados de reconocimiento, por lo que se recomienda el valor predeterminado.

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 que la autenticación es correcta. Para más información, consulte Códigos de estado.
result	Mensaje de error o información de la imagen objetivo
timestamp	Hora del servidor cuando se devuelve la respuesta. Usa formato Unix timestamp, en milisegundos
result.targetId	ID único de la imagen objetivo
result.trackingImage	Cadena codificada en base64 de la imagen de tracking
result.name	Nombre del objetivo
result.size	Ancho de la imagen de reconocimiento (unidad: cm). La altura de la imagen de reconocimiento será calculada automáticamente por el sistema según la imagen cargada. El tamaño de la imagen de reconocimiento corresponde al tamaño del contenido virtual superpuesto
result.meta	Información adicional codificada en base64, por ejemplo una cadena generada después de codificar en base64 una cadena JSON
result.type	Fijo como ImageTarget
result.active	"1" habilitado, "0" deshabilitado

Códigos de error

Consulte Lista completa de códigos de estado y códigos de error

Table of Contents