Consultar la información de un administrador

[ GET ]

Visión general

Obtén el detalle de un administrador para validar permisos, confirmar sus datos de contacto o preparar auditorías. La operación es de solo lectura y no genera cambios en la cuenta.

• URL: https://sync.airbagtech.io/manager/{MANAGER_ID}
• Uso recomendado: validaciones previas a escalar privilegios o depurar registros.

Autenticación

Incluye el encabezado Authorization: apikey {API_KEY}. Las claves API se solicitan al equipo de soporte de Airbag Tech y se asignan a contactos autorizados dentro de la organización.

Parámetro de ruta

Parámetro	Tipo	Requerido	Descripción
MANAGER_ID	String	Sí	Identificador del administrador que se desea consultar.

Ejemplo de solicitud

curl --location -g 'https://sync.airbagtech.io/manager/ADM-001' \
  --header 'Authorization: apikey ${API_KEY}'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve la ficha completa del administrador con todos sus datos.

{
  "status": true,
  "manager": {
    "airbagId": "abc123xyz",
    "company": "Transportes Ejemplo S.A.",
    "id": "ADM-001",
    "fullName": "Rosa González",
    "name": "Rosa",
    "lastName": "González",
    "email": "[email protected]",
    "phone": "+525555555555",
    "authRole": "admin",
    "gender": "female",
    "groups": ["grupo-central"],
    "status": "active",
    "created": "2024-01-15T10:30:00.000Z"
  }
}

Descripción de campos de respuesta

Campo	Tipo	Descripción
status	Boolean	Indica si la operación fue exitosa.
manager	Object	Objeto con los datos completos del administrador.

Campos dentro de manager

Campo	Tipo	Descripción
airbagId	String	Identificador interno único en la plataforma Airbag (equivalente al _id o userId en Firebase). Útil para operaciones internas y referencias cruzadas.
company	String	Nombre de la organización a la que pertenece el administrador.
id	String	Identificador único del administrador proporcionado durante la creación. Este es el ID que utilizas en tus sistemas .
fullName	String	Nombre completo del administrador (nombre + apellido).
name	String	Nombre de pila del administrador.
lastName	String	Apellido del administrador.
email	String	Correo electrónico corporativo. Canal principal de comunicación y autenticación.
phone	String	Número de teléfono con código de país (formato: +525555555555).
authRole	String	Rol de permisos asignado. Valores: admin (acceso total) o group-limited (acceso limitado a grupos específicos).
gender	String	Género del administrador. Valores: male, female, other. Campo opcional.
groups	Array	Lista de IDs de grupos asignados. .
status	String	Estado de la cuenta. Valores: active (activa) o inactive (inactiva).
created	String	Fecha y hora de creación de la cuenta en formato ISO 8601.

❌ Administrador no encontrado (400 Bad Request)

Se devuelve cuando el ID proporcionado no corresponde a ningún administrador registrado.

{
  "status": false,
  "message": "Error: Manager not found",
  "errorId": "sentry_error_id_123"
}

Respuestas y buenas prácticas

• 200 OK: devuelve la ficha completa del administrador, incluyendo rol y datos de contacto.
• 400 Bad Request: confirma que el identificador corresponda a una cuenta activa.

Recuerda validar que el rol y el grupo asignados sigan vigentes antes de utilizar estos datos en procesos automatizados.