Skip to main content

​
URL base

Todas las peticiones se realizan sobre HTTPS a: 
https://api.linahealthcareplatform.com/api/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"
      }
    ]
  }
}

​
Clientes HTTP recomendados

La API es REST estándar. Puedes usar cualquier cliente HTTP:

cURL

Ideal para testing rápido y scripts

fetch / axios (Node.js)

Clientes nativos de JavaScript

requests / httpx (Python)

Librerías estándar de Python