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
| Free | Pro und Agentur | |
|---|---|---|
| Mitteilung (alle Seiten, alle Sprachen) | unbegrenzt | unbegrenzt |
| Produkte mit GARAN-Etikett | bis 25 (Varianten zählen mit dem Hauptprodukt) | unbegrenzt |
| Regeln (Marke, Kategorie, Tag) | – | ja |
| Massen-Upsert (bis 1000 je Anfrage) | – | ja |
| Webhooks | ja | ja |
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
| Zugriff | Grenze |
|---|---|
| Secret Key | 600 je Minute und Schlüssel |
| Massen-Upsert | 30 je Minute und Schlüssel (also bis 30 000 Produkte) |
| Publishable Key | 300 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.