Herkunft
Jede Änderung über die API steht in der Chronik des Datensatzes, mit dem Handelnden und der Stecker-Marke „API“. So sieht jeder in Bodo, was eine Integration getan hat.
Was in der Chronik steht
| Aufruf mit | Chronik zeigt |
|---|---|
| persönlichem Schlüssel | den Namen der Person und die Marke „API“, etwa: Erika Mustermann hat die E-Mail geändert |
| Dienstkonto-Schlüssel | den Namen des Dienstkontos und die Marke „API“, etwa: Dienstkonto CRM-Abgleich hat einen Kontakt angelegt |
| OAuth-Token einer App | den Namen der Person, die zugestimmt hat, die Marke „API“ und die App |
Die Marke trägt im Tooltip „Über die API ausgeführt“. Welcher Schlüssel und welcher Aufruf es war, steht nicht in der Chronik, sondern im Request-Detail.
Vom Aufruf zur Änderung
- Jede Antwort trägt
Request-Idim Header, jede Fehlerantwort zusätzlichrequestIdim Body. - Im Request-Log unter Einstellungen › Schnittstellen › API-Schlüssel findest du den Aufruf über diese ID.
- Das Request-Detail zeigt die Änderungen, die genau dieser Aufruf protokolliert hat, mit Link in die Chronik.
Das Request-Log enthält keine Bodys, keine Abfragewerte und keine Datensatz-IDs. Die Verbindung zur Änderung entsteht nur über das Protokoll von Bodo selbst.
Wer was sieht
| Wer | Sieht |
|---|---|
| Inhaber eines Schlüssels | eigene Schlüssel, eigene Aufrufe, den genauen Grund jeder Absage |
| Org-Admin | alle Schlüssel und die Nutzung der Organisation |
| Jeder mit Leserecht am Datensatz | die Chronik mit Marke und Handelndem |
| Ein Schlüssel selbst | nur sich: `GET /v1/me` und `GET /v1/rate_limit`; kein Request-Log, keine Schlüsselliste |
Wie lange Bodo das Request-Log aufbewahrt, steht in den Nutzungsbedingungen.