8return

Diese Anleitung beschreibt, wie im 8returns Dashboard die erforderlichen Zugangsdaten für die Nutzung der Public API abgerufen werden.

Für die Authentifizierung werden benötigt:

• API Key

• Secret Token (dauerhafter Bearer Token)

Beide Werte werden im Dashboard bereitgestellt und müssen für externe Integrationen verwendet werden.

---

🧰 Voraussetzungen

Stelle vor Beginn sicher, dass:

• Zugriff auf das 8returns Dashboard besteht

• Ein Benutzerkonto mit Admin-Rechten oder API-/Integrationsberechtigungen verwendet wird

• Die Public API im Account freigeschaltet ist

Die API-Funktionen können je nach 8returns-Version oder Benutzerrolle variieren. Bei Unsicherheiten wende dich an den 8returns-Support.

---

⚙️ Schritt-für-Schritt-Anleitung zum Erhalt der API-Zugangsdaten

1. Anmeldung im Dashboard

1. Öffne das 8returns Dashboard (z. B. über euren gewohnten Login-Link).

2. Melde dich mit deinem Benutzerkonto an.

2. Navigieren zu den Integrationen

1. Öffne im Hauptmenü den Bereich Settings / Einstellungen.

2. Wähle anschließend Integrations / Integrationen.

3. Bereich „Public API“ öffnen

1. Suche nach dem Eintrag Public API.

2. Öffne diesen Bereich.

Hier werden die API-Zugangsdaten deines Accounts verwaltet.

4. API Key abrufen

Im Bereich Public API wird der API Key angezeigt.

Vorgehen:

1. API Key anzeigen lassen (falls ausgeblendet)

2. Wert vollständig kopieren

3. Sicher speichern (z. B. Passwortmanager oder Secret Vault)

Der API Key identifiziert deinen Account bei API-Anfragen.. Berechtigungen (Scopes) festlegen

Lege fest, auf welche Bereiche und Funktionen dein Token Zugriff haben soll. Wähle nur die Berechtigungen, die du tatsächlich benötigst.

---

5. Secret Token (dauerhafter Bearer Token) abrufen

Im selben Bereich wird zusätzlich ein Secret Token bereitgestellt. Dieser wird häufig bezeichnet als:

• Secret Token

• API Token

• Password

Vorgehen:

1. Token anzeigen lassen

2. Vollständig kopieren

3. Sicher speichern

Dieser Token dient als dauerhafter Authentifizierungswert für API-Anfragen.

6. Token neu generieren (optional)

Im Public-API-Bereich kann der Token in der Regel neu generiert werden.

Wichtige Hinweise:

• Nach einer Neugenerierung wird der bisherige Token ungültig

• Bestehende Integrationen müssen anschließend aktualisiert werden

• Der Token wird aus Sicherheitsgründen meist nur einmal vollständig angezeigt

Eine Rotation sollte nur durchgeführt werden, wenn dies sicherheitstechnisch erforderlich ist.

---

🔄 Hinweise zu Berechtigungen und Sichtbarkeit

Wenn einer der folgenden Fälle eintritt:

• „Public API“ ist nicht sichtbar

• API Key wird nicht angezeigt

• Secret Token fehlt

Dann ist in der Regel:

• die Benutzerrolle nicht ausreichend

• die API-Funktion nicht freigeschaltet

• oder der falsche Mandant/Workspace aktiv

In diesem Fall ist der 8returns Support oder der zuständige Account Manager zu kontaktieren.

---

✅ Ergebnis

Nach Abschluss dieser Schritte liegen folgende Zugangsdaten vor:

• API Key

• Secret Token (dauerhafter Bearer Token)

Diese beiden Werte werden für die Authentifizierung gegenüber der 8returns Public API benötigt und müssen sicher gespeichert werden.