Zum Hauptinhalt springen

Authentifizierung und API-Schlüssel

Die folgenden Menünamen beziehen sich auf die englische App-Oberfläche. Die Sprache dieser Anleitung und die verfügbaren App-Sprachen können sich unterscheiden.

Schlüssel ausstellen und widerrufen​

  1. Bei Heth anmelden und Business öffnen.
  2. Über Connect zur Integration wechseln.
  3. In API integration mit + einen Schlüssel erstellen.
  4. Schlüssel als Geheimnis der serverseitigen Integration speichern.
  5. Zum Widerruf den Schlüsseleintrag entfernen. Bei Ersatz die Integration aktualisieren.

Verwenden Sie keine Schlüssel aus Screenshots oder Dokumentationsbeispielen. Hier stehen Platzhalter statt nutzbarer Zugangsdaten.

Anfrage-Header​

HeaderVerwendung
x-api-keyErforderlich für Schlüssel-Authentifizierung
Content-Type: application/jsonErforderlich bei JSON-Übermittlung

Bei https://app.heth.me stellt das Heth-Gateway den Organisationskontext bereit. Dies gilt für diesen Host, nicht automatisch für andere Plattform-URLs. Der Schlüssel ist an Konto und Berechtigungen gebunden.

Schlüssel und Nutzersitzungen​

Die Transaktionsintegration akzeptiert API-Schlüssel. Interaktive Wallet-Funktionen können die Bearer-Sitzung des Nutzers verlangen; ein Schlüssel eröffnet nicht automatisch Wallets, Profil, @Namen und alle Geschäftsfunktionen. Kundensitzungen für Abonnements sind eine weitere Autorisierungsart. Ersetzen Sie keine Tokenarten gegeneinander und hinterlegen Sie keinen Seed in einer Integration.

Siehe Funktionen und Fehler. Fordern Sie nur benötigten Zugriff an.