SDKs
Hay tres librerías cliente oficiales publicadas:
| Lenguaje | Paquete | Versión | Registro | Guía |
|---|---|---|---|---|
| TypeScript | @retorna-tech/retorna-gateway-sdk | 1.0.4 | npm | Guía |
| Python | retorna-gateway-sdk | 1.0.4 | PyPI | Guía |
| Java | app.retorna:retorna-gateway-sdk | 1.0.3 | Maven Central | Guía |
Qué hace cada una por ti
Todos los SDK envuelven la misma API pública y te sacan de encima las mismas cuatro cosas:
- Intercambio de token — consigue y cachea tu token de OAuth2; no hay refresh token, así que el SDK simplemente vuelve a pedir cuando está cerca de expirar.
- Firma de requests — construye los headers
signatureynonceen RSA-SHA256 por ti, a partir de tu clave privada aprovisionada. - Reintentos — reintenta las fallas transitorias con backoff, configurable por cliente.
- Modelos tipados — las formas de request y response como tipos nativos de cada lenguaje, así un cambio de contrato aparece en tiempo de compilación, no en runtime.
Todos mandan además headers de identidad en cada request, así una llamada se puede trazar hasta el SDK y la versión exactos que la hicieron.
¿Prefieres HTTP crudo?
Nada de esto bloquea una integración. La API es HTTP sobre JSON, y las dos partes que una librería normalmente te esconde están documentadas paso a paso, con snippets ejecutables en varios lenguajes:
- Autenticación — el intercambio de token
client_credentials. - Firma de solicitudes — los headers
signatureynonce, con un ejemplo resuelto del string exacto que se firma.
De ahí en adelante, cada endpoint de la Referencia de API trae un ejemplo de request/response y un panel "Try it" que puedes llamar directamente desde el navegador.