get_command_definition_data

Para obtener los datos de definición de los comandos, utilice el método unit/get_command_definition_data.

Endpoint

Copied!
svc=unit/get_command_definition_data&params={
  "itemId": <long>,
  "col": [<long>]
}

Parámetros

Los parámetros obligatorios están marcados con un asterisco (*).

Parámetro Descripción
itemId* ID de la unidad.
col Array de ID de comandos. Si se especifica este parámetro, la respuesta contiene solo los comandos con estos ID, en el mismo orden. Los ID de comandos inexistentes se omiten.

Respuesta

Si la solicitud se completa correctamente, se devuelve una respuesta en el siguiente formato:

Copied!
[
    {
        "id": <long>,   /* ID del comando */
        "n": "<text>",  /* Nombre del comando */
        "c": "<text>",  /* Tipo de comando */
        "l": "<text>",  /* Tipo de enlace. Vacío si el tipo de enlace se selecciona automáticamente */
        "p": "<text>",  /* Parámetros */
        "a": <long>,    /* Derechos de acceso que el usuario debe tener para ejecutar el comando */
        "f": <uint>,    /* Flags */
        "jp": "<text>"  /* Parámetros JSON como texto. Vacío si no están definidos */
    }
]

El valor a es una combinación de flags de acceso. Para ejecutar el comando, el usuario debe tener todos estos derechos de acceso a la unidad, además del derecho Enviar comandos. Por ejemplo, 1 corresponde al derecho de acceso Ver objeto y sus propiedades básicas.

Los tipos de comandos y enlaces, así como los parámetros p y jp, se describen en la página unit/update_command_definition.

La respuesta no se limita a los comandos que el dispositivo puede ejecutar en ese momento. Para obtener solo esos comandos, utilice el flag Comandos disponibles del formato de datos de unidades.

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

Códigos de error

Código de error Descripción
4 Falta el parámetro itemId o no es un número.
7 La unidad no existe o el usuario no tiene el derecho de acceso Ver comandos a ella.

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