Este endpoint permite obtener una lista de dispositivos disponibles en la aplicación de seguimiento satelital. Es útil para ver todos los dispositivos que están siendo rastreados y obtener detalles básicos sobre cada uno de ellos.
Detalles de la Solicitud
La solicitud se realiza a través del método GET en la URL /api/devices. No se requieren parámetros adicionales en la URL para realizar esta solicitud.
Parámetros de la Solicitud
Este endpoint no requiere parámetros específicos en la solicitud.
Autenticación Requerida
La autenticación requerida para utilizar el endpoint es mediante un token Bearer. Este método de autenticación implica que cada solicitud debe incluir un encabezado de autorización con un token de acceso válido. Este token Bearer actúa como una credencial que verifica la identidad del usuario o aplicación que realiza la solicitud, asegurando que solo las entidades autorizadas puedan modificar la información del usuario. Al requerir este tipo de autenticación, el sistema Plaspy garantiza un nivel elevado de seguridad y control de acceso, protegiendo los datos de los usuarios contra accesos no autorizados.
Ejemplo de Solicitud
GET /api/devices
HTTP/1.1
Host: api.plaspy.com
Authorization: Bearer {token}
Parámetros de Respuesta
La respuesta de este endpoint incluye detalles sobre el éxito de la operación y, en caso de éxito, un listado de los dispositivos. La respuesta puede variar dependiendo de si la solicitud fue exitosa o si hubo algún error.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| success | boolean | Sí | Indica si la solicitud fue exitosa. |
| error | string | No | Mensaje de error en caso de que la solicitud falle. |
| apiUsage | integer | No | Uso de la API en la solicitud actual. |
| apiDailyUsage | integer | No | Uso diario de la API. |
| devices | array | No | Lista de dispositivos. Cada dispositivo es representado por un objeto con detalles específicos. |
Dentro del campo devices, cada dispositivo tiene los siguientes campos:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | No | Identificador único del dispositivo. |
| name | string | No | Nombre del dispositivo. |
| description | string | No | Descripción del dispositivo. |
| min | string | No | Mínimo valor asociado al dispositivo. |
| tags | object | No | Tags asociados al dispositivo. |
| expires | string | No | Fecha y hora de expiración del dispositivo, en formato ISO 8601. |
Ejemplo de Respuesta Exitosa
{
"apiDailyUsage": 3000,
"apiUsage": 150,
"devices": [
{
"description": "Main tracking device",
"expires": "2024-12-31T23:59:59Z",
"id": "device123",
"min": "12345",
"name": "Device 1",
"tags": {
"tag1": "value1",
"tag2": "value2"
}
},
{
"description": "Backup tracking device",
"expires": "2025-12-31T23:59:59Z",
"id": "device456",
"min": "67890",
"name": "Device 2",
"tags": {
"tagA": "valueA",
"tagB": "valueB"
}
}
],
"success": true
}Ejemplo de Respuesta de Error
Respuesta de Error 400 (Bad Request)
{
"success": false,
"error": "Bad Request",
"apiUsage": 150,
"apiDailyUsage": 3000
}Respuesta de Error 500 (Internal Server Error)
{
"success": false,
"error": "Internal Server Error",
"apiUsage": 150,
"apiDailyUsage": 3000
}Este endpoint es crucial para gestionar y supervisar los dispositivos rastreados dentro del sistema Plaspy. Permite a los usuarios obtener información detallada y actualizada sobre todos los dispositivos bajo su control.
- Bienvenido a la Ayuda de Plaspy
- Mapa
- Consultar el Historial de Recorridos de un Dispositivo
- Panel de Control de Dispositivos
- Información Detallada del Dispositivo
- Botones sobre el mapa
- Detalles
- Estadísticas de Recorridos
- Menú de Dispositivos
- Geocercas
- Edición Masiva de Alertas
- Habilitar las notificaciones
- Cálculo de kilometraje
- Atributos
- Dispositivos
- Personalizar marcador
- Información
- Sensores
- Reasignar sensores digitales
- Comandos
- Recordatorios
- Alertas
- Tipos
- Configuración
- Límites
- Historial
- Configuración de un Nuevo Rastreador
- Solución para identificador ya en uso en otra cuenta
- Problemas con el Dispositivo
- Límites de envío de alertas por correo electrónico
- Reportes
- Nuevo Reporte
- Mi cuenta
- Información de facturación
- Cambio de Contraseña
- Notificaciones por Email
- Cuentas de Telegram
- Modificar Teléfono Móvil
- Correo Electrónico Principal
- Correo Electrónico Alternativo
- Activar autenticación de dos factores (2FA)
- Registro de Acceso
- Recordar Contraseña
- Recordar Usuario
- Eliminar tu cuenta
- Subscripción
- Registro en Plaspy
- Código de Activación
- Métodos de pago
- Renovación de Líneas
- Versión Gratis
- Configuración
- Organización
- Ingreso
- Contacto
- Estilos
- Mapas
- Plantillas de correo electrónico
- Notificaciones Push
- Notificaciones Telegram
- Notificaciones WhatsApp
- Aplicación móvil
- Estadísticas
- Resumen de actividades
- Grupos
- Usuarios
- Acceso temporal
- SMS
- Aplicación Móvil
- Desarrolladores
- Activación API
- Rest API
- Autenticación
- Dispositivos API
- GET /api/devices/{deviceId}
- GET /api/devices/{deviceId}/lastLocation
- POST /api/devices/{deviceId}/locations
- POST /api/devices/{deviceId}/alerts
- GET /api/devices
- Grupos API
- GET /api/groups
- POST /api/groups
- PUT /api/groups/{groupId}
- DELETE /api/groups/{groupId}
- GET /api/groups/{groupId}
- PATCH /api/groups/{groupId}
- Users API
- GET /api/users
- POST /api/users
- GET /api/users/countries
- GET /api/users/timeZones
- GET /api/users/{userId}
- PUT /api/users/{userId}
- DELETE /api/users/{userId}
- PATCH /api/users/{userId}
- Insertar en mi página web
- Insertar el mapa en mi página web
Respondemos todas las solicitudes de soporte en 24 horas en días hábiles. Responderemos tan pronto como sea posible!
Estamos ubicados en Bogotá, Colombia, ten en cuenta la zona horaria (GMT-5).