Saltar al contenido principal
Publicamos SDKs oficiales para los tres lenguajes más usados por los clientes de OrigoID. Son los clientes oficiales y soportados — no hay variantes mantenidas por la comunidad.

​
Por qué usar un SDK en lugar de HTTP crudo

Puedes llamar a nuestros endpoints REST con curl, fetch, requests o net/http. Los SDKs agregan:
  • Modelos tipados de request y response — tu IDE autocompleta cada campo, tu compilador detecta typos, tu linter marca valores requeridos faltantes.
  • Nada que configurar más allá del API key. La URL base de producción está integrada; pasas tu key al construir el cliente y empiezas a llamar.
  • Reintentos automáticos — errores 5xx transitorios y de red se reintentan con backoff exponencial (configurable por llamada).
  • Enums fuertemente tipados — códigos type, cancellationStatus, riskLevel, etc. aparecen como enums o uniones de strings, nunca strings crudos.
  • Errores útiles — un 401 UNAUTHORIZED lanza un error tipado con el envelope ya deserializado, no un HTTPError genérico.
Si sólo necesitas llamar un endpoint ocasionalmente desde un script, curl es suficiente. Para cualquier integración productiva recomendamos el SDK.

​
Elige tu lenguaje

TypeScript / Node

npm install @origoid/sdk. Funciona en Node 18+ y Deno. Trae definiciones TypeScript integradas.

Python

pip install origoid. Python 3.9+. Cliente sync OrigoID más AsyncOrigoID para casos FastAPI / aiohttp.

Go

go get github.com/origoid/sdk-go. Context-aware, estilo Go idiomático, tipos generados para cada request y response.

Servidor MCP (integración AI)

npx @origoid/mcp-server. Funciona con Claude, ChatGPT, Gemini, Cursor, Windsurf, y cualquier otro cliente compatible con MCP. Permite que el AI haga scaffold de integraciones en cualquier lenguaje sin gastar créditos.

​
Código fuente y distribución

SDKCódigo fuenteInstalación
TypeScript / Nodegithub.com/origoid/sdk-nodenpm install @origoid/sdk
Pythongithub.com/origoid/sdk-pythonpip install origoid
Gogithub.com/origoid/sdk-gogo get github.com/origoid/sdk-go
Los tres repositorios son públicos. Los paquetes publicados en npm y PyPI son los canales oficiales de distribución; el código en GitHub se provee para que puedas auditar antes de instalar.

​
Versionado

Los SDKs siguen semver.
  • Major (1.0.0 → 2.0.0) — cambios incompatibles en la shape del SDK. Siempre acompañado por una guía de migración en las release notes.
  • Minor (0.1.0 → 0.2.0) — endpoints nuevos, campos nuevos, helpers nuevos. Compatible hacia atrás.
  • Patch (0.1.0 → 0.1.1) — fixes y mejoras.
Mientras los SDKs están en 0.x.y subimos la versión minor para cambios incompatibles (según semver pre-1.0). Cuando un SDK llega a 1.0.0 aplican las reglas semver clásicas.

​
Soporte