Zum Inhalt springen
Garanify

Limits und Caching

Was jeder Tarif kann, wie viele Anfragen erlaubt sind und wie Sie Antworten cachen.

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.

Tarife

FreePro und Agentur
Mitteilung (alle Seiten, alle Sprachen)unbegrenztunbegrenzt
Produkte mit GARAN-Etikettbis 25 (Varianten zählen mit dem Hauptprodukt)unbegrenzt
Regeln (Marke, Kategorie, Tag)–ja
Massen-Upsert (bis 1000 je Anfrage)–ja
Webhooksjaja

Ist die Free-Grenze erreicht, lehnt die API nur das nächste Etikett ab (garan_limit_reached). Vorhandene Etiketten bleiben immer sichtbar, auch wenn Pro abläuft; gespeicherte Regeln wirken weiter. Pflichtangaben verschwinden nie durch uns.

Preise unter Preise.

Rate-Limits

ZugriffGrenze
Secret Key600 je Minute und Schlüssel
Massen-Upsert30 je Minute und Schlüssel (also bis 30 000 Produkte)
Publishable Key300 je Minute, Schlüssel und Besucher
Ohne Schlüssel (Mitteilung, Sprachen, Schriften)300 je Minute und Besucher

Jede Antwort trägt RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset (Sekunden). Bei Überschreitung kommt 429 mit Retry-After. Warten Sie mindestens so lange und senden Sie dann erneut.

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 17
RateLimit-Limit: 600
RateLimit-Remaining: 0
RateLimit-Reset: 17

Caching

Der öffentliche Endpunkt und die Darstellungen sind für Caches gebaut: Browser und CDN dürfen 5 Minuten frisch ausliefern, einen Tag lang im Hintergrund erneuern und bei Ausfällen der API eine Woche lang die letzte Antwort zeigen. Mit If-None-Match kommt 304 ohne Body.

Schriften unter /v1/assets/fonts/ sind unveränderlich. Verwaltungs-Endpunkte mit Secret Key senden Cache-Control: no-store.

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: public, max-age=300, stale-while-revalidate=86400, stale-if-error=604800
ETag: "b1f0c3…"
Vary: Origin

GET /v1/public/shp_4kq8Zt2mWc9x/products/WCR870?key=gfy_pk_…
If-None-Match: "b1f0c3…"

HTTP/1.1 304 Not Modified

Wiederholen ohne Doppelung

PUT und DELETE sind von Natur aus wiederholbar. Für die anlegenden POST-Endpunkte (…/products/bulk, /v1/shops, …/keys, …/keys/{key}/rotate) senden Sie einen Idempotency-Key (z. B. eine UUID): Dieselbe Anfrage innerhalb von 24 Stunden liefert dieselbe Antwort mit Idempotent-Replayed: true, ein anderer Body mit demselben Schlüssel gibt 409 idempotency_key_reused. Gespeichert werden nur erfolgreiche Antworten; nach einem Fehler dürfen Sie denselben Schlüssel erneut senden. Die SDKs setzen den Schlüssel selbst.