Crear administrador

[ POST ]

Visión general

Utiliza este endpoint para registrar un administrador dentro de la organización. El registro garantiza que cada persona tenga un identificador único, credenciales validadas y un rol de acceso explícito antes de intervenir en los recursos críticos de la plataforma.

• URL: https://sync.airbagtech.io/manager
• Uso principal: incorporación de personal interno, socios o líderes operativos.
• Consideración: valida siempre el rol antes de enviarlo para asignar los permisos mínimos necesarios.

Autenticación y seguridad

Las solicitudes requieren el encabezado Authorization: apikey {API_KEY}. Las claves API se gestionan a través del equipo de soporte de Airbag Tech y se entregan únicamente a contactos autorizados; solicita una nueva clave cuando se incorpore un proyecto o integración.

Encabezados

Encabezado	Valor	Descripción
Content-Type	application/json	Define el formato del cuerpo.
Authorization	apikey {API_KEY}	Clave única solicitada al equipo de soporte para validar la llamada.

Cuerpo de la solicitud

Envía la información dentro del objeto manager. Los campos obligatorios permiten construir la identidad del administrador y su alcance operativo.

{
  "manager": {
    "id": "string",
    "name": "string",
    "lastName": "string",
    "email": "string",
    "authRole": "string",
    "telephone": "string",
    "birthDate": "string",
    "gender": "string",
    "group": "string"
  }
}

Descripción de campos

Campo	Tipo	Requerido	Detalle
id	String	Sí	Identificador único del administrador. Se utiliza en toda la plataforma para rastrear acciones y auditorías.
name	String	Sí	Nombre legal, usado en reportes y notificaciones.
lastName	String	Sí	Apellido legal para completar la identidad.
email	String	Sí	Correo corporativo; es el usuario de inicio de sesión y canal de recuperación.
authRole	String	Sí	Rol de permisos. Valores sugeridos: admin (acceso total) o group-limited (operaciones acotadas a un grupo).
telephone	String	Sí	Teléfono móvil con código de país (+525554535251). Sirve para notificaciones transaccionales.
birthDate	String	No	Fecha de nacimiento en formato ISO YYYY-MM-DD, útil para registros internos.
gender	String	No	Campo opcional para segmentación y métricas internas.
group	String	No	ID del grupo al que se vincula el administrador cuando es de tipo limitado.

Ejemplo de solicitud

curl --location 'https://sync.airbagtech.io/manager' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: apikey ${API_KEY}' \
  --data '{
    "manager": {
      "id": "ADM-001",
      "name": "Rosa",
      "lastName": "González",
      "email": "[email protected]",
      "authRole": "group-limited",
      "telephone": "+525555555555",
      "birthDate": "1990-05-01",
      "gender": "female",
      "group": "grupo-central"
    }
  }'

Respuestas y recomendaciones

• 201 Creado: el administrador quedó habilitado y recibirá invitación por correo.
• 400 Solicitud incorrecta: revisa campos obligatorios o formato del teléfono.
• 409 Conflicto: el id o email ya existe; utiliza un identificador diferente.

Para mantener la gobernanza de accesos, documenta internamente quién solicita cada alta y revisa periódicamente que las credenciales sigan siendo necesarias.