Zugangsberechtigungen
Eingeschränkte Passdaten mit Käufer oder Recycler teilen und wieder entziehen: erstellen, auflisten, ändern, widerrufen und Zugriffsprotokoll.
/api/v1/access-grantsZugangsberechtigung erstellen
Geben Sie einem Empfänger Zugriff auf den eingeschränkten Teil Ihrer Pässe, nach denselben Regeln wie im Dashboard: Die Rolle bestimmt, welche Datenpunkte die Berechtigung zeigt, eine Käufer-Berechtigung nennt die Pässe, die sie abdeckt, und endet beim Eigentümerwechsel der Batterie, und ein Unternehmen hat höchstens 50 aktive Berechtigungen.
/api/v1/access-grantsZugangsberechtigungen auflisten
Die Zugangsberechtigungen des Unternehmens, neueste zuerst, per Cursor. Eine Zugangsberechtigung ist die Berechtigung, mit der ein Empfänger (Käufer, Reparaturbetrieb, Recycler) den eingeschränkten Teil eines Passes liest. Die Liste gibt nie ein Token zurück, auch keinen Teil davon.
/api/v1/access-grants/{id}Zugangsberechtigung lesen
Eine Berechtigung Ihres Unternehmens, aktiv, abgelaufen oder widerrufen. Das Feld `state` sagt, welche. Die Antwort enthält nie das Token oder einen Teil davon.
/api/v1/access-grants/{id}Zugangsberechtigung ändern
Label, Zweck, Nachweis, Ablauf oder Umfang einer aktiven Berechtigung ändern. Senden Sie nur die Schlüssel, die sich ändern sollen, mindestens einen. Die Rolle lässt sich nicht ändern: Widerrufen Sie die Berechtigung und erstellen Sie eine neue. Eine Behörden-Berechtigung (Behörden-Rolle oder Stufe authority) lässt sich nur im Dashboard ändern: über die API ergibt sie `400 role_dashboard_only`.
/api/v1/access-grants/{id}Zugangsberechtigung widerrufen
Eine Berechtigung widerrufen: Ihr Token funktioniert sofort nicht mehr. Idempotent: Das Widerrufen einer bereits widerrufenen Berechtigung ergibt erneut `200` mit ihr. Nur eine ID, die nicht Ihrem Unternehmen gehört, ergibt `404`. Eine Behörden-Berechtigung (Behörden-Rolle oder Stufe authority) lässt sich nur im Dashboard widerrufen: über die API ergibt sie `400 role_dashboard_only`.
/api/v1/access-grants/{id}/activityZugriffsprotokoll einer Zugangsberechtigung
Die Protokollzeilen der Berechtigung, neueste zuerst, per Cursor. Ereignisse (`grant_created`, `grant_changed`, `grant_revoked`) nennen, wer gehandelt hat: `via` ist der API-Schlüssel (mit seinem Label) oder die OAuth-App und `null` für das Dashboard; `actorId` ist der Nutzer, für den gehandelt wurde. `read`-Zeilen tragen eine Zahl pro Pass, Kanal und Tag.