update_trailer
Para crear, modificar o eliminar remolques, utilice el método resource/update_trailer.
Endpoint
svc=resource/update_trailer¶ms={
"itemId": <long>,
"id": <long>,
"callMode": <text>,
"n": <text>,
"c": <text>,
"ds": <text>,
"f": <uint>,
"ej": { ... },
"jp": {
<text>: <text>,
...
}
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
itemId |
ID del recurso. |
id |
ID del remolque. Para crear un remolque, envíe 0. |
callMode |
Tipo de acción: create, update, delete, reset_image (eliminar la imagen del remolque). |
n |
Nombre del remolque. Solo es obligatorio para los tipos de acción create y update. |
c |
Código del remolque. Solo es obligatorio para los tipos de acción create y update. |
ds |
Descripción del remolque. Solo es obligatorio para los tipos de acción create y update. |
f |
Flags, no se emplean actualmente. Opcional. |
ej |
JSON extendido. Opcional. Si no se especifica el parámetro, se establece {} al crear un remolque y se conserva el valor actual al modificarlo. |
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 del remolque, o de eliminación de su imagen, se completa con éxito, la respuesta se devuelve en el siguiente formato:
[
<long>, /* ID del remolque. */
{
"id": <long>, /* ID del remolque. */
"n": <text>, /* Nombre. */
"c": <text>, /* Código. */
"ej": { ... }, /* JSON extendido. */
"jp": { /* Campos personalizados. */
<text>: <text>, /* Nombre: valor. */
...
},
"pwd": <text>, /* Contraseña para la autorización móvil (no se usa para remolques). */
"ds": <text>, /* Descripción. */
"p": <text>, /* Número de teléfono. */
"r": <double>, /* Relación de aspecto de la imagen. */
"f": <uint>, /* Flags. */
"ck": <ushort>, /* Suma de comprobación de la imagen. */
"ct": <uint>, /* Hora de creación (marca de tiempo Unix). */
"mt": <uint>, /* Hora de la última modificación (marca de tiempo Unix). */
"bu": <long>, /* Unidad asignada. */
"pu": <long>, /* Unidad asignada anteriormente. */
"bt": <uint>, /* Hora de la última asignación/separación. */
"bs": <long>, /* ID del sensor que confirma la asignación. */
"pos": { /* Ubicación. */
"y": <double>, /* Latitud. */
"x": <double> /* Longitud. */
}
}
]
Si la solicitud de eliminación del remolque se completa con éxito, la respuesta se devuelve en el siguiente formato:
[
<long>, /* ID del remolque. */
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 el remolque 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 el remolque con el ID indicado. |
| 7 | El recurso no existe o el usuario no tiene el derecho de acceso Crear, modificar y eliminar remolques a él. |