Insights

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.

Tarif-Upgrade nötig

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. 1

    Key-Bereich öffnen

    Im Dashboard unter „Insights → API-Keys". Du siehst eine Liste aller bestehenden Keys.

  2. 2

    Neuen Key generieren

    Klicke „Neuen Key erstellen". Trage einen sprechenden Namen ein (z. B. „Power BI Sync") und wähle die Berechtigungen.

  3. 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. 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. 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. 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

Niemals in Git, E-Mails oder Slack einchecken. Wenn ein Key versehentlich publik wird, sofort widerrufen und neu erzeugen.

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?
Du kannst Berechtigungen und IP-Beschränkungen nachträglich anpassen. Den Key-Wert selbst kannst du nicht ändern — wenn du ihn rotieren willst, erzeuge einen neuen und widerrufe den alten.
Was passiert bei einem widerrufenen Key?
Reguly antwortet mit HTTP 401 auf alle weiteren Requests dieses Keys. Im Audit-Log wird der Widerruf protokolliert.
Kann ich Webhooks nutzen?
Ja — im Reiter „Webhooks" konfigurierst du URLs, an die Reguly POST-Requests bei bestimmten Events sendet (z. B. neue DOC, abgelaufenes Zertifikat).
Werden API-Calls geloggt?
Ja, jeder Aufruf erscheint im Reiter „Nutzung" mit Zeitstempel, Endpoint und Status. So kannst du Probleme bei Drittsystemen nachvollziehen.

Verwandte Seiten