Skip to main content

API-Token

Die API-Token-Methode von Configure PDF Service 2.0 CH EU eSeal verwendet einen festen API-Token, der im Benutzerprofil des Unterzeichners erstellt wird. Der API-Token ist für die Autorisierung in Postman bei fast jedem API-Aufruf erforderlich. Sie benötigen keine weiteren Anmeldeinformationen.

Authentifizierung mit einem API-Token

So authentifizieren Sie sich mit einem API-Token:

Erstellen Sie Ihr API-Token

Die API-Token haben dieselben Berechtigungen und denselben Geltungsbereich wie der Administrator, der sie erstellt.

Anmerkung

Um API-Token zu erstellen, benötigt ein Administrator die Berechtigung Account Manager > Benutzer anzeigen. Siehe DigiCert ONE-Zugriff.

  1. Melden Sie sich mit Ihrem Unterzeichner-Berechtigungsnachweis bei DigiCert ONE an.

  2. Wählen Sie in DigiCert ONE im oberen Menü rechts das Personensymbol > Admin-Profil aus.

  3. Wählen Sie auf der Seite Admin im Abschnitt API-Token die Option API-Token erstellen aus.

  4. Fügen Sie auf der Seite API-Token erstellen die erforderlichen Details hinzu:

    1. Name

      Geben Sie einen Namen für das API-Token ein. Dieser Name ist der Anzeigename auf den API-Token-Karten. Der Name muss eindeutig sein und darf nur Buchstaben, Zahlen, Leerzeichen, Bindestriche und Unterstriche enthalten.

    2. Enddatum (optional)

      Das Hinzufügen eines Enddatums ist nicht erforderlich. Das Enddatum ist in UTC angegeben. Wenn Sie beispielsweise den 12. August 2023 als Enddatum auswählen, läuft Ihr API-Token am 12. August 2023 um 23:59:59 UTC ab.

      Anmerkung

      Wenn Sie ein Enddatum hinzufügen, sollten Sie sich notieren, wann das API-Token abläuft. Sie müssen alle API-Integrationen mit dem API-Token aktualisieren, bevor es abläuft. Wenn Sie dies nicht tun, funktionieren die API-Token-Integrationen nicht mehr.

      Sie können die API-Token-Details jederzeit bearbeiten und das Ablaufdatum verlängern, bevor es abläuft.

  5. Wählen Sie Erstellen.

  6. Kopieren Sie auf der Seite Herzlichen Glückwunsch das API-Token und speichern Sie es an einem sicheren Ort, damit Sie es später verwenden können.

    Wichtig

    Das API-Token wird nur einmal angezeigt. Nach der Auswahl von Fertigstellen können Sie nicht mehr darauf zugreifen. Wenn Sie das API-Token verlieren, müssen Sie das verlorene Token löschen und ein neues erstellen.

  7. Nachdem Sie den Token gespeichert haben, wählen Sie Fertigstellen aus.

API-Token in Postman-Umgebung festlegen und verwenden

  1. Öffnen Sie Postman.

  2. Wählen Sie im Postman-Fenster Umgebungen (Menü auf der linken Seite) > PDF Service 2.0 Umgebung aus.

  3. Geben Sie Ihren API-Token in das Feld „Aktueller Wert“ der Variable „api_key“ ein.

  4. Wählen Sie das Symbol „Speichern“ (oben rechts) aus.

In diesem Abschnitt: