update_round

Para crear, editar o eliminar rutinas, utilice el método route/update_round:

Copied!

svc=route/update_round
params={
  "itemId": <long>,
  "id": <long>,
  "callMode": <text>,
  "n": <text>,
  "d": <text>,
  "u": <long>,
  "at": <uint>,
  "vt": <uint>,
  "vp": <uint>,
  "sh": <long>,
  "cu": [<long>],
  "f": <uint>,
  "tz": <uint>
}

Parámetros

La solicitud debe contener los siguientes parámetros:

Parámetro	Descripción
itemId	ID de la ruta.
id	ID de la rutina.
callMode	Acción: `create`, `update`, `delete`.
sh	ID del horario. Obligatorio si la acción es `create` o `update`.

Para la descripción de los demás parámetros, consulte get_round_data.

Respuesta

Si la solicitud se completa con éxito, el formato de la respuesta depende de la acción especificada en el parámetro callMode.

La respuesta a la solicitud de creación o actualización de una rutina se devuelve en el siguiente formato:

Copied!

[
  <long>,                  // ID de la rutina.
  {
    "id": <long>,          // ID de la rutina.
    "ct": <long>,          // Hora de creación de la rutina (UNIX).
    "mt": <long>,          // Hora de actualización de la rutina (UNIX).  
    "n": <text>,           // Nombre.
    "d": <text>,           // Descripción.
    "sh": <text>,          // Nombre del horario.
    "f": <uint>,           // Flags de la rutina.
    "tz": <uint>,          // Zona horaria.
    "u": <long>,           // Unidad asignada. Si no se especifica, este campo muestra la primera unidad del array "cu" que sale del primer punto de control.
    "at": <uint>,          // Hora de activación.
    "vt": <uint>,          // Inicio del periodo de validez.
    "vp": <uint>,          // Periodo de validez.
    "sts": <uint>,         // Flags de estado de la rutina.

    "st": {                // Estado de la rutina.
      "st": {              // Estado general de la rutina.
        "pi": <uint>,      // Índice del punto de control (4294967295 si no ha comenzado).
        "ps": <uint>,      // Flags de estado y de eventos.
        "ut": <uint>       // Hora del último evento.
      },
      "pts": {             // Estado por punto de control.
        "<checkpoint_id>": {
          "st": <uint>,    // Flags de eventos.
          "tm": <uint>     // Hora del último evento.
        }
        // ... puntos de control adicionales
      }
    }
  }
]

Los flags de estado y de eventos de la rutina se describen en la página get_round_data.

La respuesta a la solicitud de eliminación de una rutina se devuelve en el siguiente formato:

Copied!

[
  <long>,  // ID de la rutina.
  null
]

Si la solicitud falla, se devuelve un código de error.

Códigos de error

Código de error	Descripción
4	Uno de los siguientes errores: parámetros JSON no válidos; parámetro `callMode` no válido; falta la unidad requerida o las unidades que se pueden asignar a la rutina; parámetros del horario no válidos o faltantes.
6	Error interno.
7	Error interno.