Autenticación

Métodos de autenticación

La API de LINA utiliza Bearer tokens para autenticar las peticiones. Existen dos formas de autenticarte:

Método	Uso recomendado	Duración
API Key directa	Desarrollo y testing	Permanente
Token JWT	Producción	1 hora

API Keys

Generar una API Key

Accede a Configuración → API Keys en el panel de LINA
Haz clic en Generar nueva clave
Asigna un nombre descriptivo y selecciona los permisos
Copia y guarda la clave de forma segura

La API Key solo se muestra una vez. Si la pierdes, deberás generar una nueva.

Permisos disponibles

Permiso	Descripción
`patients:read`	Leer datos de pacientes
`patients:write`	Crear y modificar pacientes
`forms:read`	Acceder a formularios y respuestas
`schedules:write`	Crear y gestionar programaciones
`conversations:write`	Iniciar conversaciones IA
`calls:write`	Realizar llamadas automatizadas
`credits:read`	Consultar saldo de créditos
`webhooks:write`	Gestionar webhooks

Token JWT

Para producción, intercambia tu API Key por un token JWT de corta duración:

curl -X POST https://api.linahealthcareplatform.com/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "lina_sk_xxxxxxxxxxxx"}'

Usa el token en todas las peticiones:

curl https://api.linahealthcareplatform.com/api/v1/patients \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Seguridad

Mejores prácticas:

Almacena las API Keys en variables de entorno
Usa tokens JWT para aplicaciones en producción
Rota las API Keys periódicamente
Asigna los mínimos permisos necesarios
Nunca expongas credenciales en código del lado del cliente

Errores de autenticación

Código	Descripción
`401`	Token inválido o expirado
`403`	Permisos insuficientes para la acción
`429`	Rate limit excedido

Comenzar

Guías

Métodos de autenticación

API Keys

Generar una API Key

Permisos disponibles

Token JWT

Seguridad

Errores de autenticación

​Métodos de autenticación

​API Keys

​Generar una API Key

​Permisos disponibles

​Token JWT

​Seguridad

​Errores de autenticación

Métodos de autenticación

API Keys

Generar una API Key

Permisos disponibles

Token JWT

Seguridad

Errores de autenticación