Wialon para desarrolladores Manual de usuario Documentación de API retranslator update_units

update_units

Para agregar unidades a un repetidor, quitarlas de él o cambiar sus ajustes de retransmisión, utilice el método retranslator/update_units.

Endpoint

Copied!
svc=retranslator/update_units&params={
    "itemId": <long>,
    "units": [{
        "i": <long>,
        "a": <text>,
        "st": <uint>
    }],
    "callMode": <text>
}

Parámetros

La solicitud puede contener los siguientes parámetros. Los parámetros obligatorios están marcados con un asterisco (*).

Parámetro Descripción
itemId* ID del repetidor.
units* Matriz de unidades para la retransmisión.
i* ID de la unidad.
a* Identificador (alias) con el que la unidad se retransmite al servidor receptor. Puede ser distinto del ID de la unidad.
st Hora (marca de tiempo Unix) en la que la unidad se elimina automáticamente del repetidor. Si el valor es 0 o el parámetro no se indica, la unidad no se elimina automáticamente.
callMode Modo de la solicitud:
  • add: agrega las unidades indicadas y actualiza los ajustes de las que ya están agregadas al repetidor;
  • remove: elimina las unidades indicadas del repetidor;
  • no se indica: agrega las unidades indicadas y elimina del repetidor todas las demás unidades.

Respuesta

Si la solicitud se completa con éxito, la lista actual de unidades del repetidor se devuelve en el siguiente formato:

Copied!
{
    "rtru":[
        {
            "i":<long>,   /* ID de la unidad. */
            "a":<text>,   /* Identificador (alias) con el que la unidad se retransmite al servidor receptor. Puede ser distinto del ID de la unidad. */
            "st":<uint>   /* Hora (marca de tiempo Unix) en la que la unidad se elimina automáticamente del repetidor. 0 si la hora no está establecida. */
        }
    ]
}

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 obtener la lista actual de unidades del repetidor.
6 Error al generar la respuesta.
7 El elemento indicado no es un repetidor o el usuario no tiene el derecho de acceso para modificar los ajustes del repetidor, incluidos su inicio y detención (bit ACL 0x100000, véase Tokens).

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