Autenticación

Aprende cómo autenticarte con la API de Qualth

API Key Authentication

Para autenticarte con la API de administración e integración, debes incluir tu API Key en el header X-API-Key de todas las solicitudes.

Ejemplo de solicitud:

curl -X GET "https://api.qualth.com/api/programs" \
  -H "X-API-Key: your_api_key_here"

Nota: Mantén tu API Key segura y nunca la compartas públicamente. Puedes obtener tu API Key desde el panel de administración de Qualth.

JWT Token Authentication

Para autenticarte con la API del portal de clientes, primero debes obtener un JWT token mediante el endpoint de login.

1. Iniciar sesión

POST/api/customer/login
curl -X POST "https://api.qualth.com/api/customer/login" \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Subdomain: your_subdomain" \
  -d '{
    "email": "customer@example.com",
    "password": "SecurePass123!"
  }'

2. Usar el token JWT

Incluye el token en el header Authorization con el prefijo Bearer:

curl -X GET "https://api.qualth.com/api/customer/profile" \
  -H "Authorization: Bearer your_jwt_token_here"

Nota: Los tokens JWT tienen una duración limitada. Asegúrate de manejar la renovación de tokens en tu aplicación.

Tenant Subdomain

Algunos endpoints del Customer Portal API requieren el header X-Tenant-Subdomain para identificar tu organización.

X-Tenant-Subdomain: your_company_subdomain

Códigos de Error Comunes

  • 401Unauthorized - API Key o JWT token inválido o ausente
  • 403Forbidden - No tienes permisos para acceder a este recurso
  • 429Too Many Requests - Has excedido el límite de solicitudes