Reguly

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.

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 Sie eine eigene App bauen, die Reguly-Daten anzeigen soll.

Schritt für Schritt: Key erstellen

  1. 1

    Key-Bereich öffnen

    Im Dashboard unter „Insights → API-Keys". Sie sehen eine Liste aller bestehenden Keys.

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

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 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?
Sie können Berechtigungen und IP-Beschränkungen nachträglich anpassen. Den Key-Wert selbst können Sie nicht ändern — wenn Sie ihn rotieren wollen, erzeugen Sie 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" konfigurieren Sie 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 können Sie Probleme bei Drittsystemen nachvollziehen.

Verwandte Seiten