update_config
Para actualizar la configuración de la ruta, utilice el método route/update_config. Puede crear una ruta mediante el método core/create_route.
La configuración se reemplaza por completo, no se actualiza campo por campo. Indique en la solicitud todos los campos que necesita: los campos que no se indican se pierden. Un objeto
configvacío borra toda la configuración.
Endpoint
svc=route/update_config
params={
"itemId": <long>,
"config": {
"color": <long>,
"descr": <text>,
"units": [<long>]
}
}
Parámetros
La solicitud debe contener los parámetros itemId y config. El servidor no comprueba el contenido del objeto config, por lo que los campos que se indican a continuación son los que utiliza la interfaz de Wialon.
| Parámetro | Descripción |
|---|---|
itemId |
ID de la ruta. |
config |
Configuración de la ruta. |
color |
Color de la ruta (ARGB). |
descr |
Descripción de la ruta. |
units |
Array de los ID de las unidades que realizan las rutinas. Los ID no se comprueban, por lo que un ID inexistente se guarda tal cual. |
Respuesta
Si la solicitud se completa con éxito, la configuración guardada se devuelve en el siguiente formato:
{
"rcfg": { // Configuración de la ruta.
"color": <long>, // Color de la ruta (ARGB).
"descr": <text>, // Descripción de la ruta.
"units": [<long>] // Array de ID de unidades.
}
}
La respuesta repite la configuración de la solicitud, por lo que contiene solo los campos que se indicaron.
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Error al analizar los parámetros de entrada o al guardar la configuración. |
| 6 | Error al generar la respuesta. |
| 7 | No se encuentra la ruta, el elemento indicado no es una ruta o el usuario no tiene el derecho de acceso Modificar propiedades de la ruta a ella. |