Cómo enviar comandos a rastreadores usando REST API
Esta guía te mostrará cómo enviar comandos a un rastreador usando REST API y cómo enviar comandos a múltiples activos dentro de un Grupo (Etiqueta).
Requisitos
El recurso de Comandos REST API requiere la siguiente información al usarlo:
- Lee cómo habilitar REST API
- Lee cómo generar el token de REST API
- Lee cómo obtener un ID de aplicación
- Lee cómo obtener el userID de un activo
- Lee cómo obtener el deviceID de un Grupo (Etiqueta) de usuarios/activos
Recursos utilizados
- Comandos > Get
- Comandos > Post
Ver comandos disponibles
Este paso es opcional, pero ayuda a recuperar los comandos ya disponibles de los rastreadores.
Para ver los comandos disponibles para un rastreador, sigue estos pasos:
1. Inicia sesión en http://host_name/comGpsGate/api/v.1/test
Nota: reemplaza host_name con la dirección IP real de tu servidor o el nombre DNS.
2. Haz clic en el nombre del recurso GET/applications/...../commands> Probar opción.
3. Ingresa los siguientes detalles:
- applicationid = el ID de la aplicación. Lee aquí cómo obtenerlo.
- userid = el ID del activo con privilegios para leer esos comandos. Lee aquí cómo obtenerlo.
- deviceid = el ID del rastreador. Puedes obtenerlo de la misma manera que applicationid, ingresando el nombre del activo en su lugar. Si deseas obtener el deviceID de múltiples rastreadores, Lee cómo obtener el deviceID de un Grupo (Etiqueta) de usuarios/activos.
Si los comandos están disponibles, se listarán en el área de Respuesta
Enviando el comando
1. Inicia sesión en http://host_name/comGpsGate/api/v.1/test
Nota: reemplaza host_name con la dirección IP real de tu servidor o el nombre del host.
2. Haz clic en el nombre del recurso POST/applications/...../commands> Probar opción.
3. Ingresa los siguientes detalles:
- applicationid = el ID de la aplicación. Lee aquí cómo obtenerlo.
- userid = el ID del activo con privilegios para leer esos comandos. Lee aquí cómo obtenerlo.
- deviceid = el ID del rastreador. Puedes obtenerlo de la misma manera que applicationid, ingresando el nombre del activo en su lugar. Si deseas obtener el deviceID de múltiples rastreadores, Lee cómo obtener el deviceID de un Grupo (Etiqueta) de usuarios/activos.
- command = el comando que deseas enviar al rastreador, por ejemplo:
{
"command": "getinfo"
}
Nota: asegúrate de que tu rastreador sea compatible con el comando que intentas enviar. Consulta la documentación de tu rastreador para enviar los comandos correctos a tus rastreadores.
Si el comando fue exitoso, verás el estado 200 y la Respuesta a continuación: