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. Acepta acentos, minúsculas o mayúsculas combinadas; antes de almacenarse se normaliza automáticamente a mayúsculas y sin acentos.
lastName	String	Sí	Apellido legal para completar la identidad. Acepta acentos, minúsculas o mayúsculas combinadas; antes de almacenarse se normaliza automáticamente a mayúsculas y sin acentos.
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	male, female u other. 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.

aviso

Por ahora el campo group se acepta pero no se guarda en el administrador. Se está corrigiendo; mientras tanto, asigna el grupo desde la plataforma de Airbag.

Normalización de nombres

Los campos name y lastName aceptan valores con acentos, minúsculas o mayúsculas combinadas. Antes de almacenar el registro, Airbag normaliza automáticamente el valor convirtiéndolo a mayúsculas y eliminando acentos. Esta transformación no rechaza la petición ni modifica los datos en el sistema de origen del cliente.

Ejemplo: José Ramírez será almacenado como JOSE RAMIREZ.

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"
    }
  }'

Respuesta

Devuelve los campos enviados, tal como se enviaron.

aviso

Por ahora la respuesta no incluye el airbagId del administrador creado. Se está corrigiendo; mientras tanto, consúltalo con Consultar administrador usando tu id.

{
  "status": true,
  "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

• 200 OK: el administrador quedó registrado. Puedes usar tu id en los demás endpoints de administradores.
• 400 Solicitud incorrecta: falta un campo obligatorio, un campo no cumple las validaciones o el cuerpo incluye campos no permitidos. La respuesta es {"status": false, "message", "errorId"}.

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