Cargando ...

PUT /api/groups/{groupId}

Este endpoint permite actualizar los detalles de un grupo existente. Es esencial para mantener la información de los grupos actualizada, incluyendo su nombre, descripción y dispositivos asociados. La actualización de un grupo puede ser necesaria cuando hay cambios en la estructura del equipo o en la organización de los dispositivos.

Detalles de la Solicitud

Para actualizar un grupo, debe enviar una solicitud PUT con los detalles del grupo en el cuerpo de la solicitud. Asegúrese de que la solicitud esté autorizada con un token válido y que el identificador del grupo (groupId) sea correcto.

Parámetros de la Solicitud

Parámetros de la Ruta

Campo Tipo Obligatorio Descripción
groupId string Identificador único del grupo que se va a actualizar

Parámetros del Cuerpo de la Solicitud

Campo Tipo Obligatorio Descripción
name string 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": "Grupo Actualizado", "description": "Descripción actualizada del grupo", "devices": ["dev-123", "dev-456"] }

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

PUT /api/groups/grp-125 HTTP/1.1 Host: api.plaspy.com Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXV... Content-Type: application/json { "name": "Grupo Actualizado", "description": "Descripción actualizada del grupo", "devices": ["dev-123", "dev-456"] }

Parámetros de Respuesta

La respuesta incluye detalles del grupo actualizado.

Campo Tipo Obligatorio Descripción
success boolean 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 actualizado.
name string 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": "Grupo Actualizado", "description": "Descripción actualizada del grupo", "devices": ["dev-123", "dev-456"], "creation": "2023-01-01T12:00:00Z", "lastModified": "2023-06-01T12:00:00Z" }

Ejemplo de Respuesta de Error

{ "success": false, "error": "Group not found", "apiUsage": 123, "apiDailyUsage": 45 }

Este endpoint es esencial para mantener la información de los grupos en la aplicación Plaspy actualizada, permitiendo modificar detalles específicos de un grupo existente para reflejar cambios en la organización o en la asignación de dispositivos.

Índice
Preguntas

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).

Última modificación: 2024-06-05 20:01:05