Desarrolladores

Conecte el sistema de su institución con Kuida

Una API REST para que el sistema de gestión de una clínica, un laboratorio, una farmacia o un prestador le cuente a Kuida lo que pasa con sus pacientes. Kuida se encarga del seguimiento por WhatsApp; su sistema sigue siendo la fuente de los datos.

Primeros pasos Referencia de la API

Qué se puede integrar

Pacientes

Alta e identificación por teléfono, DNI o id propio. Base de todo lo demás.

Turnos

Cada turno cargado recibe los recordatorios por WhatsApp de la institución.

Consultas

Una consulta atendida arranca el seguimiento posconsulta del paciente.

Solicitudes de ingreso

Pedidos de servicio que Kuida completa por WhatsApp con los datos faltantes.

Tratamientos

Medicación, terapias y estudios indicados, en la ficha del paciente.

Webhooks

Avisos firmados a su sistema cuando algo cambia en Kuida.

Si su sistema ya emite eventos, puede enviarlos tal cual con el sobre común de eventos, sin adaptarlos a cada recurso.

Empezar en cinco minutos

1. Pedir una clave de API
Kuida emite las claves para cada organización. Escriba a desarrolladores@kuida.ar o a su contacto comercial. No hay alta autoservicio.
2. Instalar un SDK
Hay SDKs oficiales para Node y Python, o se puede usar HTTP directo.
```
npm install @kuida/sdk
```
3. Hacer el primer pedido
GET /v1/account devuelve la organización dueña de la clave. Si responde, la integración está bien configurada.

GET /v1/account

curl https://www.kuida.ar/api/v1/account \
  -H "Authorization: Bearer kd_test_…"

Respuesta

{
  "id": "org_cm1a2b3c4d5e6f7g8h9i0j",
  "object": "account",
  "name": "Institución Demo",
  "type": "clinic",
  "timeZone": "America/Argentina/Buenos_Aires",
  "serviceLines": [
    "follow_up"
  ],
  "livemode": false,
  "apiKey": {
    "name": "Sistema de turnos",
    "prefix": "kd_test_0a1b2c3d4e5f",
    "scopes": [
      "patients:read",
      "patients:write"
    ]
  }
}

SDKs oficiales

Node

@kuida/sdk

Python

kuida

El código de los dos está en github.com/Kuida-ar/kuida-sdks, con licencia MIT.

Datos básicos

URL base: https://www.kuida.ar/api/v1
Autenticación: Clave de API en Authorization: Bearer
Formato: JSON con claves en camelCase
Versión vigente: 2026-09-28
Límite: 600 pedidos por minuto por clave
Contrato: OpenAPI 3.1