> ## Documentation Index
> Fetch the complete documentation index at: https://docs.origoid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs — visión general

> Librerías oficiales en TypeScript, Python y Go. Un método por endpoint, idiomáticas a cada ecosistema.

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

<CardGroup cols={2}>
  <Card title="TypeScript / Node" icon="js" href="/es/sdks/node">
    `npm install @origoid/sdk`. Funciona en Node 18+ y Deno. Trae
    definiciones TypeScript integradas.
  </Card>

  <Card title="Python" icon="python" href="/es/sdks/python">
    `pip install origoid`. Python 3.9+. Cliente sync `OrigoID` más
    `AsyncOrigoID` para casos FastAPI / aiohttp.
  </Card>

  <Card title="Go" icon="golang" href="/es/sdks/go">
    `go get github.com/origoid/sdk-go`. Context-aware, estilo Go
    idiomático, tipos generados para cada request y response.
  </Card>

  <Card title="Servidor MCP (integración AI)" icon="robot" href="/es/sdks/mcp">
    `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.
  </Card>
</CardGroup>

## Código fuente y distribución

| SDK               | Código fuente                                                          | Instalación                        |
| ----------------- | ---------------------------------------------------------------------- | ---------------------------------- |
| TypeScript / Node | [github.com/origoid/sdk-node](https://github.com/origoid/sdk-node)     | `npm install @origoid/sdk`         |
| Python            | [github.com/origoid/sdk-python](https://github.com/origoid/sdk-python) | `pip install origoid`              |
| Go                | [github.com/origoid/sdk-go](https://github.com/origoid/sdk-go)         | `go 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](https://semver.org/lang/es/).

* **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

* Preguntas del API, requests de features, o reportes de bugs del SDK: [support@origoid.com](mailto:support@origoid.com)
* Estado del servicio: [status.origoid.com](https://status.origoid.com)