Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lina.doolehealth.com/llms.txt

Use this file to discover all available pages before exploring further.

URL base

Todas las peticiones se realizan sobre HTTPS a:
https://api.lina.health/v1

Versionado

La API usa versionado en la URL. La versión actual es v1. Las versiones anteriores se mantienen durante un mínimo de 12 meses tras la publicación de una nueva versión.

Autenticación

Todas las peticiones requieren un token Bearer en el header Authorization:
Authorization: Bearer YOUR_TOKEN
Consulta la guía de autenticación para obtener tu token.

Formato de peticiones

  • Content-Type: application/json
  • Accept: application/json
  • Todos los cuerpos de petición y respuesta usan JSON.
  • Las fechas siguen el formato ISO 8601 (2026-05-14T10:30:00Z).
  • Los IDs usan prefijos descriptivos (pat_, form_, call_, sch_, conv_, wh_).

Formato de respuesta

Todas las respuestas exitosas siguen esta estructura:
Recurso individual
{
  "id": "pat_xyz789",
  "firstName": "María",
  "lastName": "García",
  "email": "maria.garcia@email.com",
  "createdAt": "2026-05-14T10:00:00Z"
}
Lista paginada
{
  "data": [
    { "id": "pat_xyz789", "firstName": "María", ... },
    { "id": "pat_abc123", "firstName": "Carlos", ... }
  ],
  "pagination": {
    "cursor": "eyJpZCI6InBhdF9hYmMxMjMifQ==",
    "hasMore": true,
    "limit": 20
  }
}

Paginación

Los endpoints que devuelven listas usan paginación basada en cursor:
ParámetroTipoDescripción
limitintegerNúmero de resultados por página (máx. 100, por defecto 20)
cursorstringCursor opaco devuelto en la respuesta anterior para obtener la siguiente página
Para recorrer todas las páginas, repite la petición usando el cursor de la respuesta hasta que hasMore sea false.

Códigos de error

CódigoSignificadoDescripción
400Bad RequestLa petición tiene parámetros inválidos o falta un campo obligatorio
401UnauthorizedToken no proporcionado o inválido
403ForbiddenNo tienes permisos para acceder a este recurso
404Not FoundEl recurso solicitado no existe
429Too Many RequestsHas superado el límite de peticiones
500Internal Server ErrorError interno del servidor. Contacta con soporte si persiste
Formato de error:
{
  "error": {
    "code": "validation_error",
    "message": "El campo 'email' es obligatorio.",
    "details": [
      {
        "field": "email",
        "message": "Este campo es obligatorio"
      }
    ]
  }
}

SDKs oficiales

Node.js / TypeScript

npm install @lina-health/sdk

Python

pip install lina-health