SDKs
Offizielle Clients für TypeScript und Python, generiert aus dem OpenAPI-Schema.
Beide SDKs sind schlanke, typisierte Hüllen um die REST-API. Sie setzen den Authorization-Header, wiederholen 429-Antworten anhand von Retry-After, folgen keinen Weiterleitungen und iterieren die Cursor-Pagination für dich. Alles andere, auch Request- und Response-Formen, stammt direkt aus dem OpenAPI-Schema; die API-Referenz gilt daher auch für die SDKs.
TypeScript
@adlass/api auf npm. Typisierte Pfade mit openapi-fetch, läuft in Node.js 20+, Deno, Bun und Edge-Runtimes.
Python
adlass auf PyPI. httpx-Client mit generierten Modellen für Python 3.10+.
Versionierung
Die SDK-Versionen folgen dem Schema: eine kompatible Schemaänderung erhöht die Minor-Version, eine inkompatible die Major-Version. Beide Pakete werden gemeinsam aus demselben Schema-Commit veröffentlicht; sdk-release.json im Portal-Repository hält fest, welcher das war.
Idempotency-Keys
Bei Schreiboperationen senden die SDKs pro Aufruf einen neuen Idempotency-Key, wenn du keinen angibst. Das schützt vor den Wiederholungen des SDK selbst, nicht vor Wiederholungen in deinem Code. Wenn dein Code einen Aufruf nach Timeout oder Absturz erneut ausführen kann, übergib deinen eigenen Key, damit beide Versuche denselben teilen. Die Anleitung zur Idempotenz erklärt die Regeln.