API-Keys
Wenn du Reguly-Daten in einem anderen System nutzen willst — z. B. dein ERP, ein Analyse-Tool oder eine Channel-Plattform — brauchst du einen API-Key. Hier verwaltest du Keys, setzt Berechtigungen und siehst, was darüber abgefragt wurde.
Wozu API-Keys?
- ERP-Anbindung: Produkte und Verpackungsdaten zwischen ERP und Reguly synchronisieren.
- Channel-Partner: Großhändler oder Marktplätze können DOCs und DPPs auf Knopfdruck abrufen.
- BI-Auswertungen: Reguly-Daten in Looker, Power BI, Metabase o. ä. einlesen.
- Eigene Custom-Apps: Falls du eine eigene App baust, die Reguly-Daten anzeigen soll.
Schritt für Schritt: Key erstellen
- 1
Key-Bereich öffnen
Im Dashboard unter „Insights → API-Keys". Du siehst eine Liste aller bestehenden Keys.
- 2
Neuen Key generieren
Klicke „Neuen Key erstellen". Trage einen sprechenden Namen ein (z. B. „Power BI Sync") und wähle die Berechtigungen.
- 3
Berechtigungen setzen
Du wählst pro Bereich: Lesen, Schreiben oder kein Zugriff. Beispiel: Read-Only auf Produkte und DOCs, kein Zugriff auf Account.
- 4
IP-Beschränkung (optional)
Du kannst angeben, von welchen IP-Adressen der Key gültig ist — extra Sicherheit, falls dein Drittsystem eine feste IP hat.
- 5
Key kopieren
Reguly zeigt den Key einmalig im Klartext — kopiere ihn jetzt und lege ihn sicher ab. Wir können den Key nicht erneut anzeigen.
- 6
Key in Drittsystem eintragen
Im Drittsystem trägst du den Key als Bearer-Token ein. Reguly nutzt OAuth-2.0-Bearer-Auth für maximale Kompatibilität.
Keys sind wie Passwörter
Verfügbare API-Endpunkte
Reguly bietet eine REST-API mit folgenden Hauptendpunkten:
/api/v1/products— Produkte lesen, anlegen, aktualisieren./api/v1/docs— DoCs lesen, generieren./api/v1/passports— DPPs lesen, aktualisieren./api/v1/reports— Mengenmeldungen lesen, exportieren./api/v1/analytics— Anonymisierte Reichweiten-Daten lesen.
Volle Endpoint-Referenz mit Beispielen findest du unter https://reguly.eu/api/docs.
Rate Limits
- Standard-Tarif: 60 Requests/Minute, 10.000 Requests/Tag
- Pro-Tarif: 300 Requests/Minute, 100.000 Requests/Tag
- Enterprise: nach Vereinbarung
Bei Überschreitung antwortet Reguly mit HTTP 429 und einem Retry-After-Header. Du siehst aktuelle Rate-Limits auch im Dashboard.
FAQ
Kann ich einen Key später ändern?
Was passiert bei einem widerrufenen Key?
Kann ich Webhooks nutzen?
Werden API-Calls geloggt?
Verwandte Seiten