Alle Anleitungen

Team und Verwaltung

API-Tokens

Lassen Sie Programme, Skripte und Automatisierungen Sealed Print mit einem API-Token verwalten.

Ein API-Token gibt einem Programm Zugriff auf die REST API von Sealed Print, zum Beispiel um Aufträge zu verfolgen, Ziele zu verwalten oder die Warteschlange aus einem Skript zu lesen. Ein Token handelt im Namen der Person, die es erstellt hat, mit höchstens ihren Berechtigungen und nur in der Organisation, in der es erstellt wurde. Die API-Referenz beschreibt jeden Endpunkt mit Beispielen.

Voraussetzungen

  • Jedes Mitglied kann in einer Browser-Sitzung Tokens erstellen. Admins sehen alle Tokens der Organisation und können sie widerrufen.
  • Tokens verwalten und steuern Sealed Print: Aufträge, Quellen, Ziele und Einstellungen. Sie können keine Aufträge einreichen; Programme senden Dokumente stattdessen an einen API-Endpunkt.
  • In jedem Tarif enthalten.

Einmalige Einrichtung

  1. Gehen Sie zu Einstellungen → API-Tokens und wählen Sie Neues Token.
  2. Geben Sie einen Namen ein, der sagt, wofür das Token verwendet wird, zum Beispiel „Rechnungsexport Buchhaltung“.
  3. Wählen Sie die Berechtigungen: Benutzer (Ihre eigenen Quellen, Ziele und Aufträge), Admin oder Inhaber, höchstens Ihre eigene Rolle.
  4. Wählen Sie den Ablauf: 7, 30 oder 90 Tage, 1 Jahr, ein eigenes Datum oder kein Ablauf.
  5. Wählen Sie Erstellen und kopieren Sie das Token. Es wird nur jetzt angezeigt; bewahren Sie es sicher auf, zum Beispiel in einem Passwort-Manager.

Senden Sie das Token bei jeder Anfrage im Header Authorization: Bearer sp_api_…. So listen Sie Ihre Aufträge auf:

curl "https://www.sealedprint.com/api/jobs" \
  -H "Authorization: Bearer sp_api_…"

Mit demselben Header verfolgt Ihr Programm einen Auftrag (GET /api/jobs/{id}), sendet ihn an weitere Ziele oder bricht ihn ab.

Jedes Mal

  • Zuletzt verwendet in der Liste der Tokens zeigt, ob ein Programm das Token noch nutzt.
  • Umbenennen ändert den Namen; Neu ausstellen erzeugt ein neues Geheimnis für dasselbe Token (das alte funktioniert sofort nicht mehr, Name, Berechtigungen und Ablauf bleiben); Widerrufen beendet es endgültig.
  • Abgelaufene und widerrufene anzeigen führt Tokens auf, die nicht mehr funktionieren.

Fehlerbehebung

  • HTTP 401: Das Token fehlt, ist falsch, abgelaufen oder widerrufen.
  • HTTP 403: Die Berechtigungen des Tokens erlauben die Aktion nicht. Aufträge mit einem Token einzureichen ist nicht möglich (Code api_endpoint_required); senden Sie das Dokument an einen API-Endpunkt.
  • Ein Token funktioniert plötzlich nicht mehr: Tokens werden ungültig, wenn die Person, die sie erstellt hat, die Organisation verlässt. Erstellen Sie ein neues Token mit einem anderen Mitglied.
  • Das Token wurde an eine Stelle kopiert, an die es nicht gehört: Wählen Sie sofort Neu ausstellen oder Widerrufen.

Wie geht es weiter