Changelog
Änderungen an API, SDKs und MCP-Server. Aktuelle Version der Spezifikation: 1.0.0. Was als kompatibel gilt, steht unter Versionierung.
Die API ist gebaut und getestet. Das Hosting unter api.garanify.com ist in Vorbereitung; bis dahin läuft sie lokal. Schlüssel gibt es auf Anfrage.
-
1.0.0· in Vorbereitung, noch nicht öffentlich erreichbar
Erste Version: Shops, Schlüssel, Produkte (auch Massen-Upsert), Regeln, Auflösung mit Grund, Darstellung von Mitteilung und GARAN-Etikett, öffentlicher Endpunkt für das Snippet, Webhooks.
- Vor dem Release geändert:
lastDeliveryam Webhook-Endpunkt ist jetzt{ at, ok, outcome }statt eines HTTP-Status.outcomeistdelivered,rejectedoderunreachable. - Webhooks: Zustellungen der letzten 30 Tage abrufen, erneut senden, Test-Ereignis
webhook.test, KatalogGET /v1/webhook-events, HeaderGaranify-Webhook-Id. - Webhooks gehen nur an öffentliche Adressen; Weiterleitungen werden nicht verfolgt.
- Testmodus: Test-Shops mit
gfy_sk_test_…undgfy_pk_test_…, alle Funktionen ohne Lizenz, Feldlivemodein Shop,/v1/meund Ereignissen. Neuer Fehlerlive_key_required(403) beim Verknüpfen von Lizenzen. - Jede Antwort trägt
Request-Id; Fehler enthaltenrequestId. Idempotency-Keyauch für Shop anlegen, Schlüssel anlegen und Schlüssel rotieren.- Neuer Fehler
account_shop_limit(409), wenn ein Konto die Höchstzahl an Shops erreicht hat. 429mitRateLimit-*undRetry-Afterist an jedem Endpunkt dokumentiert.- CORS für Test-Secret-Keys, damit „Ausprobieren“ in der Doku funktioniert. Live-Secret-Keys bekommen weiter kein CORS.
- SDKs
@garanify/sdk(Node.js) undgaranify/sdk(PHP) sowie der MCP-Server@garanify/mcpin Version 0.1.0, noch nicht veröffentlicht.
- Vor dem Release geändert:
Die Änderungen der Plugins und der Website stehen im allgemeinen Changelog. Die Spezifikation: openapi.yaml.