Entwickler-API
GARAN-Labels programmgesteuert und in beliebigem Umfang erzeugen
Eine saubere REST-API für das EU-Label der Haltbarkeitsgarantie. Binden Sie sie in Ihr PIM, Ihren Online-Shop oder Ihre Build-Pipeline ein und erhalten Sie normkonforme Labels in jedem benötigten Format.
Gebaut für die Integration
- REST über JSON:API
- Vorhersehbare Ressourcen, Filterung und Paginierung nach dem JSON:API-Standard, sodass Ihre Client-Bibliothek den Großteil der Arbeit übernimmt.
- Einzelne Labels oder Stapelaufträge
- Ein Label pro Anfrage erstellen oder einen Stapel mit bis zu 500 Zeilen in die Warteschlange stellen, der im Hintergrund gerendert wird und als ZIP zurückkommt.
- Alle Formate und Varianten
- SVG, PDF, PNG, JPG und WebP in den Varianten Farbe, Schwarz-Weiß und Nested, alles aus derselben Anfrage.
Endpunkte
Was Sie automatisieren können
Die API spiegelt alles, was Sie manuell tun können, ohne die Klicks. Ein Überblick darüber, was die einzelnen Bereiche leisten.
- Ein Label erstellen
- Garantiedauer, Marke und Modell übermitteln und das Label mit sofort nutzbaren Download-Links je Format erhalten.
- Ihre Bibliothek durchsuchen
- Alle von Ihrem Konto erzeugten Labels auflisten und abrufen, neueste zuerst, jederzeit zum kostenlosen erneuten Rendern bereit.
- Einen Stapelauftrag in die Warteschlange stellen
- Viele Zeilen auf einmal einreichen und den Stapel abfragen, bis er fertig ist, dann das fertige ZIP abrufen.
- Nutzung und Guthaben prüfen
- Aktuelles Guthaben und aktuelle Aktivität abrufen, damit Ihre Integration das Konto im Blick behält.
Konventionen
Vorhersehbar by design
Die API folgt überall einer kleinen Menge von Regeln. Sobald Sie einen Endpunkt integriert haben, wissen Sie, wie sich die übrigen verhalten.
- Token-Authentifizierung
- Persönliche Zugriffstoken in Ihren Einstellungen erstellen und als Bearer-Token im Authorization-Header mitsenden. Jedes Token ist jederzeit widerrufbar.
- Versionierte Endpunkte
- Alles liegt unter /api/v1, sodass künftige Änderungen Ihre bestehende Integration nie ohne Ankündigung beeinträchtigen.
- JSON:API-Medientyp
- Anfragen und Antworten verwenden application/vnd.api+json mit Ressourcen, Beziehungen und einem konsistenten Envelope.
- Deterministisch und gecacht
- Dieselben drei Eingaben erzeugen immer dasselbe Label. Antworten tragen einen ETag, sodass Wiederholungsanfragen ein schnelles 304 Not Modified zurückgeben.
- Signierte Download-Links
- Gerenderte Dateien werden über kurzlebige signierte URLs ausgeliefert, sodass Sie einen Link direkt an einen Browser weitergeben können, ohne Ihr Token preiszugeben.
- Rate-Limits
- Ein großzügiges Limit je Konto hält den Dienst fair und reaktionsschnell. Das Limit wird in Standard-Headern zurückgegeben, damit Sie graceful zurückweichen können.
- Strukturierte Fehler
- Fehler kommen als JSON:API-Fehlerdokumente zurück, die auf das genaue Attribut zeigen, das fehlgeschlagen ist, damit Validierungsprobleme leicht angezeigt werden können.
Preise
Einmal pro Label zahlen
Die Abrechnung erfolgt einmalig je einzigartigem Label, identifiziert durch Garantiedauer, Marke und Modell. Ein Label erneut herunterladen, weitere Formate anfordern oder ein bereits in Ihrem Besitz befindliches Label abrufen, kostet nichts.
Prepaid-Guthaben aufladen oder auf nutzungsbasierte Abrechnung umstellen und monatlich genau das bezahlen, was Sie erzeugen. Doppelte Zeilen in einem Stapel werden nur einmal gezählt.
Lieber ohne Code?
Eine Tabellenkalkulation hochladen und dieselben Labels im Stapel erzeugen, ohne Integration.
Im großen Maßstab
Hunderte Labels automatisch erzeugen
Mit einem kostenlosen Konto erzeugen Sie GARAN-Labels im Stapel oder per API, statt eines nach dem anderen. Sie zahlen erst, wenn Sie skalieren.
- Stapelverarbeitung per CSV, bis zu 500 Zeilen je Datei, als ZIP zurück.
- REST-API für PIM, Online-Shop oder Build-Pipeline.
- Alle fünf Formate und drei Varianten aus einer einzigen Anfrage.
- Gespeicherte Bibliothek, Abrechnung einmalig je einzigartigem Label (Prepaid oder nutzungsbasiert).