KuidaDesarrolladores

Empezar

SDKs

Bibliotecas oficiales para Node (con tipos de TypeScript) y Python, con el mismo comportamiento en las dos.

El código de los dos está en github.com/Kuida-ar/kuida-sdks, con licencia MIT. Cada carpeta tiene su README con un ejemplo por recurso.

Node

Código fuente

npm @kuida/sdk. Node 18 o superior. ESM y CommonJS, con tipos incluidos.

Terminal
npm install @kuida/sdk

Python

Código fuente

PyPI kuida. Python 3.9 o superior.

Terminal
pip install kuida

Configuración

El cliente se construye con la clave de API. Si no se pasa, se lee de la variable de entorno KUIDA_API_KEY; sin clave, falla al construirse y no en el primer pedido. Un cliente se puede reutilizar en todo el proceso.

Crear el cliente
import { Kuida } from "@kuida/sdk";

// Sin argumento, el cliente lee KUIDA_API_KEY del entorno.
const kuida = new Kuida(process.env.KUIDA_API_KEY);
baseUrl
Defaulthttps://www.kuida.ar/api
Para quéURL base. También se lee de KUIDA_API_BASE.
timeout
Default30 s
Para quéTiempo máximo de cada intento.
maxRetries
Default2
Para quéReintentos ante errores transitorios.
apiVersion
Default2026-09-28
Para quéValor del header Kuida-Version.

En Python las opciones van en snake_case (base_url, max_retries, api_version). Además, cada método acepta al final opciones por pedido: la Idempotency-Key, el tiempo de espera y la cantidad de reintentos.

Lo que hacen los dos

  • Un método por operación de la API, con el nombre del identificador de la referencia: patients.create es kuida.patients.create() en Node y client.patients.create() en Python.
  • Una Idempotency-Key en cada POST, la misma en todos los reintentos del pedido. Ver Idempotencia.
  • Reintentos con espera creciente ante errores de red, 409 idempotency_key_in_use, 429 y 500, 502, 503 y 504, respetando Retry-After.
  • Una clase de excepción por tipo de error. Ver Errores.
  • Verificación de la firma de webhooks con Webhook.constructEvent. Ver Webhooks.
  • Los campos conservan los nombres de la API, en camelCase, en Python también como atributos en snake_case (patient.full_name). Los campos nuevos que agregue la API se ignoran sin error.

Otros lenguajes

¿Necesita otro lenguaje? Escríbanos a desarrolladores@kuida.ar. Mientras tanto, la API es HTTP y JSON, y el contrato en OpenAPI 3.1 (/api/v1/openapi.json) sirve para generar un cliente con las herramientas habituales.