SDKs
Clientes oficiales para TypeScript y Python, generados a partir del esquema OpenAPI.
Ambos SDKs son envolturas ligeras y tipadas de la API REST. Añaden la cabecera Authorization, reintentan las respuestas 429 según Retry-After, rechazan redirecciones e iteran la paginación por cursor por ti. Todo lo demás, incluidas las formas de solicitud y respuesta, proviene directamente del esquema OpenAPI, por lo que la referencia de la API también aplica a los SDKs.
TypeScript
@adlass/api en npm. Rutas tipadas con openapi-fetch; funciona en Node.js 20+, Deno, Bun y runtimes edge.
Python
adlass en PyPI. Cliente httpx con modelos generados para Python 3.10+.
Versionado
Las versiones de los SDKs siguen al esquema: un cambio compatible incrementa la versión minor; uno incompatible, la major. Ambos paquetes se publican juntos desde el mismo commit del esquema, y sdk-release.json en el repositorio del portal registra cuál fue.
Claves de idempotencia
En las operaciones de escritura, los SDKs envían un Idempotency-Key nuevo por llamada si no indicas uno. Eso te protege de los reintentos del propio SDK, no de los reintentos en tu código. Si tu código puede repetir una llamada tras un timeout o una caída, pasa tu propia clave para que ambos intentos la compartan. La guía de idempotencia explica las reglas.