Wialon para desarrolladores Manual de usuario Documentación de API unit send_cmd

send_cmd

Para enviar un comando a la unidad, utilice el método unit/send_cmd.

Copied!

svc=unit/send_cmd&params={
    "itemId": <long>,
    "commandType": <text>,
    "commandName": <text>,
    "linkType": <text>,
    "param": <text>,
    "timeout": <uint>,
    "flags": <uint>
}

Parámetros

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

Parámetro	Descripción
`itemId`*	ID de la unidad.
`commandType`*	Tipo de comando. Ver abajo.
`commandName`	Nombre del comando. Si no se especifica, se utiliza el tipo de comando como nombre.
`linkType`*	Canal por el que se debe enviar el comando. Ver abajo.
`param`*	Parámetros del comando.
`timeout`*	Tiempo durante el cual el comando puede esperar en la cola, en segundos.
`flags`	Flags para seleccionar el número de teléfono por el que se ejecuta el comando: `0`: utilizar cualquiera (primero el principal, luego el secundario) `0x1`: utilizar el principal `0x2`: utilizar el secundario `0x10`: enviar `param` en formato JSON.

Tipos de comandos

Tipo de comando	Descripción
`block_engine`	Bloquear el motor.
`unblock_engine`	Desbloquear el motor.
`custom_msg`	Enviar un mensaje personalizado.
`driver_msg`	Enviar un mensaje al conductor.
`download_msgs`	Descargar mensajes.
`query_pos`	Solicitar la ubicación de la unidad.
`query_photo`	Solicitar una foto.
`output_on`	Activar una salida.
`output_off`	Desactivar una salida.
`send_position`	Enviar coordenadas.
`set_report_interval`	Definir un intervalo de transferencia de datos.
`upload_cfg`	Cargar una configuración.
`upload_sw`	Cargar firmware.

Canales

Valor	Canal
Cadena vacía	Automático
`tcp`	TCP
`udp`	UDP
`vrt`	Virtual
`gsm`	SMS

Ejemplo

A continuación se muestra un ejemplo de la solicitud unit/send_cmd.

Copied!

svc=unit/send_cmd&params={"itemId":1351,"commandType":"custom_msg","commandName":"pin","linkType":"","param":"pin 0000","timeout":60,"flags":0}

Respuesta

Si la solicitud se completa correctamente, se devuelve una respuesta vacía.

Copied!

{ }

De lo contrario, se devuelve un código de error.

Códigos de error

Código de error	Descripción
4	Parámetros de entrada incorrectos.
5	Error al enviar el comando.
7	La unidad no existe o el usuario no tiene todos los siguientes derechos de acceso a ella: Ver comandos, Crear, modificar y eliminar comandos y Enviar comandos.

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