update_tag
Para crear, modificar o eliminar etiquetas, utilice el método resource/update_tag. Las etiquetas se emplean al asignar o separar pasajeros.
Endpoint
svc=resource/update_tag¶ms={
"itemId": <long>,
"id": <long>,
"callMode": <text>,
"n": <text>,
"c": <text>,
"tz": <int>,
"f": <int>,
"art": <uint>,
"jp": {
<text>: <text>,
...
}
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
itemId |
ID del recurso. |
id |
ID de la etiqueta. Para crear una etiqueta, envíe 0. |
callMode |
Tipo de acción: create, update, delete, reset_image (eliminar la imagen de la etiqueta). |
n |
Nombre de la etiqueta. Solo es obligatorio para los tipos de acción create y update. |
c |
Código de la etiqueta. Solo es obligatorio para los tipos de acción create y update. |
tz |
Zona horaria. Opcional. Si no se especifica el parámetro, se establece la zona horaria del creador del recurso. |
f |
Flags. Opcional. 0 por defecto. |
art |
Tiempo de espera para el reinicio automático. Opcional. 36000 (10 horas) por defecto. |
jp |
Campos personalizados en el formato "nombre":"valor". Opcional. Si no se especifica el parámetro, los campos personalizados se borran. |
Respuesta
Si la solicitud de creación o modificación de la etiqueta, o de eliminación de su imagen, se completa con éxito, la respuesta se devuelve en el siguiente formato:
[
<long>, /* ID de la etiqueta. */
{
"id": <long>, /* ID de la etiqueta. */
"n": <text>, /* Nombre. */
"c": <text>, /* Código. */
"jp": { /* Campos personalizados. */
<text>: <text>, /* Nombre: valor. */
...
},
"r": <double>, /* Relación de aspecto de la imagen. */
"ck": <ushort>, /* Suma de comprobación de la imagen. */
"f": <ushort>, /* Flags, no se emplean actualmente. 1 por defecto. */
"bu": <long>, /* Unidad asignada. */
"pu": <long>, /* Unidad asignada anteriormente. */
"bt": <uint>, /* Hora de la última asignación/separación. */
"tz": <int>, /* Zona horaria. */
"art": <uint>, /* Tiempo de espera para el reinicio automático. */
"pos": { /* Ubicación. */
"y": <double>, /* Latitud. */
"x": <double> /* Longitud. */
},
"ct": <uint>, /* Hora de creación (marca de tiempo Unix). */
"mt": <uint> /* Hora de la última modificación (marca de tiempo Unix). */
}
]
Si la solicitud de eliminación de la etiqueta se completa con éxito, la respuesta se devuelve en el siguiente formato:
[
<long>, /* ID de la etiqueta. */
null
]
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos. Para el tipo de acción update, este error también se devuelve si no existe la etiqueta con el ID indicado. |
| 6 | Error no definido. Para los tipos de acción delete y reset_image, este error también se devuelve si no existe la etiqueta con el ID indicado. |
| 7 | El recurso no existe o el usuario no tiene el derecho de acceso Crear, modificar y eliminar pasajeros a él. |