Editar administrador
[ PUT ]
Visión general
Actualiza la información de un administrador sin necesidad de recrear su cuenta. Este proceso es ideal para ajustar roles, actualizar datos de contacto o reasignar grupos cuando cambian las responsabilidades.
- URL:
https://sync.airbagtech.io/manager/{MANAGER_ID} - Compatibilidad: permite modificar atributos individuales sin afectar el historial de actividades.
Autenticación
Requiere el encabezado Authorization: apikey {API_KEY}. Las claves se solicitan a soporte de Airbag Tech y se renuevan periódicamente para mantener un control riguroso de accesos.
Encabezados
| Encabezado | Valor | Descripción |
|---|---|---|
Content-Type | application/json | Formato del cuerpo de la solicitud. |
Authorization | apikey {API_KEY} | Clave entregada por soporte para autorizar la operación. |
Cuerpo de la solicitud
{
"manager": {
"name": "string",
"lastName": "string",
"email": "string",
"authRole": "string",
"telephone": "string",
"birthDate": "string",
"gender": "string",
"group": "string"
}
}
Campos disponibles
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
name | String | No | Nombre legal actualizado del administrador. |
lastName | String | No | Apellido para reflejar cambios en documentación. |
email | String | No | Correo corporativo; actualízalo si cambia el dominio o el puesto. |
authRole | String | No | Rol de permisos (admin o group-limited). |
telephone | String | No | Teléfono móvil con código de país para notificaciones. |
birthDate | String | No | Fecha en formato ISO YYYY-MM-DD si requieres mantener registros internos. |
gender | String | No | Campo opcional para segmentaciones internas. |
group | String | No | ID del grupo asociado cuando el rol es limitado. |
Ejemplo de solicitud
curl --location -g --request PUT 'https://sync.airbagtech.io/manager/ADM-001' \
--header 'Content-Type: application/json' \
--header 'Authorization: apikey ${API_KEY}' \
--data '{
"manager": {
"name": "Rosa",
"lastName": "González",
"email": "[email protected]",
"authRole": "admin",
"telephone": "+525555555555",
"birthDate": "1990-05-01",
"gender": "female",
"group": "grupo-central"
}
}'
Respuestas
- 200 OK: datos actualizados; los cambios aplican inmediatamente.
- 400 Solicitud incorrecta: revisa formatos o valores de rol no soportados.
- 404 No encontrado: el
MANAGER_IDno existe o fue dado de baja.
Procura notificar al usuario cuando haya cambios críticos, como actualizaciones de rol o de correo corporativo.