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 una Etiqueta.
Requisitos
El recurso Commands 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 una Etiqueta de usuarios/activos
Recursos utilizados
- Commands > Get
- Commands > Post
Ver comandos disponibles
Este paso es opcional, pero ayuda a recuperar 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> Try it out 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 una Etiqueta de usuarios/activos.
Si los comandos están disponibles, se listarán en el área de Response
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> Try it out opción.
3. Ingrese los siguientes detalles:
- applicationid = el ID de la aplicación. Lea aquí cómo obtenerlo.
- userid = el ID del activo con privilegios para leer esos comandos. Lea aquí cómo obtenerlo.
- deviceid = el ID del rastreador. Puede obtenerlo de la misma manera que applicationid, ingresando el nombre del activo en su lugar. Si desea obtener el deviceID de múltiples rastreadores, Lea cómo obtener el deviceID de una Etiqueta de usuarios/activos.
- command = el comando que desea enviar al rastreador, por ejemplo:
{
"command": "getinfo"
}
Nota: asegúrese de que su rastreador sea compatible con el comando que intenta enviar. Consulte la documentación de su rastreador para enviar los comandos correctos a sus rastreadores.
Si el comando fue exitoso, verá el estado 200 y la Respuesta a continuación: