Zum Inhalt springen
Garanify

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. 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: lastDelivery am Webhook-Endpunkt ist jetzt { at, ok, outcome } statt eines HTTP-Status. outcome ist delivered, rejected oder unreachable.
    • Webhooks: Zustellungen der letzten 30 Tage abrufen, erneut senden, Test-Ereignis webhook.test, Katalog GET /v1/webhook-events, Header Garanify-Webhook-Id.
    • Webhooks gehen nur an öffentliche Adressen; Weiterleitungen werden nicht verfolgt.
    • Testmodus: Test-Shops mit gfy_sk_test_… und gfy_pk_test_…, alle Funktionen ohne Lizenz, Feld livemode in Shop, /v1/me und Ereignissen. Neuer Fehler live_key_required (403) beim Verknüpfen von Lizenzen.
    • Jede Antwort trägt Request-Id; Fehler enthalten requestId.
    • Idempotency-Key auch 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.
    • 429 mit RateLimit-* und Retry-After ist 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) und garanify/sdk (PHP) sowie der MCP-Server @garanify/mcp in Version 0.1.0, noch nicht veröffentlicht.

Die Änderungen der Plugins und der Website stehen im allgemeinen Changelog. Die Spezifikation: openapi.yaml.