Este endpoint permite crear un nuevo grupo dentro del sistema. Es esencial para organizar dispositivos y gestionarlos eficientemente agrupándolos en unidades lógicas. Cada grupo puede tener un nombre único, una descripción y una lista de dispositivos asociados.
Detalles de la Solicitud
Para crear un grupo, debe enviar una solicitud POST con los detalles del grupo en el cuerpo de la solicitud. Asegúrese de que la solicitud esté autorizada con un token válido.
Parámetros de la Solicitud
El cuerpo de la solicitud debe incluir los detalles del grupo que se va a crear.
Parámetros del Cuerpo de la Solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | string | Sí | El nombre del grupo. Debe ser una cadena no vacía. |
| description | string | No | Una descripción del grupo. |
| devices | array | No | Lista de IDs de dispositivos asociados con el grupo. |
Ejemplo del Cuerpo de la Solicitud
{
"name": "Nuevo Grupo",
"description": "Descripción del nuevo grupo",
"devices": ["dev-456", "dev-789"]
}
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
POST /api/groups HTTP/1.1
Host: api.plaspy.com
Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXV...
Content-Type: application/json
{
"name": "Nuevo Grupo",
"description": "Descripción del nuevo grupo",
"devices": ["dev-456", "dev-789"]
}
Parámetros de Respuesta
La respuesta incluye detalles del grupo recién creado.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| success | boolean | Sí | Indica si la solicitud fue exitosa. |
| error | string | No | Mensaje de error si la solicitud falló. |
| apiUsage | integer | No | Uso total de la API en el momento de la solicitud. |
| apiDailyUsage | integer | No | Uso diario de la API en el momento de la solicitud. |
| id | string | No | Identificador único del grupo creado. |
| name | string | Sí | Nombre del grupo. |
| description | string | No | Descripción del grupo. |
| devices | array | No | Lista de IDs de dispositivos asociados con el grupo. |
| creation | string | No | Fecha y hora de creación del grupo (en formato ISO 8601). |
| lastModified | string | No | Fecha y hora de la última modificación del grupo (en formato ISO 8601). |
Ejemplo de Respuesta Exitosa
{
"success": true,
"error": null,
"apiUsage": 123,
"apiDailyUsage": 45,
"id": "grp-125",
"name": "Nuevo Grupo",
"description": "Descripción del nuevo grupo",
"devices": ["dev-456", "dev-789"],
"creation": "2023-06-01T12:00:00Z",
"lastModified": "2023-06-01T12:00:00Z"
}
Ejemplo de Respuesta de Error
{
"success": false,
"error": "Entrada inválida",
"apiUsage": 123,
"apiDailyUsage": 45
}
Este endpoint es crucial para agregar nuevos grupos a la aplicación Plaspy, permitiendo una mejor organización y gestión de dispositivos al agruparlos en unidades con nombre y descripción.
- 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).