Insights
API-Keys
Wenn Sie Reguly-Daten in einem anderen System nutzen wollen — z. B. Ihr ERP, ein Analyse-Tool oder eine Channel-Plattform — brauchen Sie einen API-Key. Hier verwalten Sie Keys, setzt Berechtigungen und sehen, 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 Sie eine eigene App bauen, die Reguly-Daten anzeigen soll.
Schritt für Schritt: Key erstellen
- 1
Key-Bereich öffnen
Im Dashboard unter „Insights → API-Keys". Sie sehen eine Liste aller bestehenden Keys.
- 2
Neuen Key generieren
Klicken Sie „Neuen Key erstellen". Tragen Sie einen sprechenden Namen ein (z. B. „Power BI Sync") und wählen Sie die Berechtigungen.
- 3
Berechtigungen setzen
Sie wählen pro Bereich: Lesen, Schreiben oder kein Zugriff. Beispiel: Read-Only auf Produkte und DOCs, kein Zugriff auf Account.
- 4
IP-Beschränkung (optional)
Sie können angeben, von welchen IP-Adressen der Key gültig ist — extra Sicherheit, falls Ihr Drittsystem eine feste IP hat.
- 5
Key kopieren
Reguly zeigt den Key einmalig im Klartext — kopieren Sie ihn jetzt und legen Sie ihn sicher ab. Wir können den Key nicht erneut anzeigen.
- 6
Key in Drittsystem eintragen
Im Drittsystem tragen Sie 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 finden Sie 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. Sie sehen 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

