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 config vacío borra toda la configuración.

Endpoint

Copied!
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:

Copied!
{
  "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.

Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.