Veröffentlichte API
Was dieses Unternehmen freigibt und wer darauf zugreifen darf. Nichts ist von außen erreichbar, bis es veröffentlicht wird: ein Bildschirm, seine Spalten und Zeilen, die weitergegeben werden können. Die Software wird registriert, erhält einen Schlüssel, spezifische Zugriffsrechte und wird an die Adressen gebunden, von denen aus sie genutzt werden darf. Dieselbe Veröffentlichung dient als Schnittstelle für eine REST-API, ein pro Schlüssel generiertes OpenAPI-Dokument und einen MCP-Server für einen KI-Agenten.
12 Schritte · 10 Fragen · 6 Bildschirme in diesem Regal
Die Bildschirme in diesem Regal
Arbeitsplatz
API Studio
Ein Board für die gesamte veröffentlichte API: was offengelegt wird, wer einen Schlüssel besitzt, was jeder Schlüssel tatsächlich nicht kann und jeder Aufruf der letzten Tage mit dem Grund für jede Ablehnung.
Offen
Aufzeichnungen
Expositionen
Eine einmal getroffene Entscheidung legt fest, dass ein einzelner Bildschirm das Unternehmen verlassen darf – welche Spalten, welche Zeilen und ob etwas zurückgeschrieben werden darf. Nichts ist von außen zugänglich, bevor es hier veröffentlicht wurde, und es gibt kein „Alles veröffentlichen“.
Offen
Aufzeichnungen
API-Clients
Die externe Software enthält den Schlüssel zu diesem Unternehmen. Jeder Aufruf erfolgt unter dem Namen eines namentlich genannten Benutzers, sodass die Software nur auf Ressourcen zugreifen kann, auf die dieser Benutzer bereits Zugriff hat. Der Schlüssel wird einmalig bei der Ausstellung angezeigt und danach nie wieder.
Offen
Aufzeichnungen
API-Berechtigungen
Welche Software kann welche Zugriffsrechte erhalten und mit welchen Verben? Zwei Partner können die Schlüssel zu diesem Unternehmen besitzen und auf völlig unterschiedliche Daten zugreifen; der Rückzug eines Partners ändert nichts für den anderen.
Offen
Aufzeichnungen
Zulässige Software
Ein Schlüssel kann von verschiedenen Quellen stammen: einem Browserursprung, einem Host, einer Adresse oder einem Netzwerk. Ein Schlüssel, der eine Zulassungsliste erfordert und keine Einträge enthält, hat keine Reichweite – „keine angegebenen Adressen“ bedeutet „noch nicht erreichbar“, niemals „überall erreichbar“.
Offen
Aufzeichnungen
API-Aufrufprotokoll
Jeder mit einem API-Schlüssel getätigte Aufruf, ob genehmigt oder abgelehnt, mit Angabe des Ablehnungsgrundes. Dies ist kein Audit-Log – dieses protokolliert die tatsächliche Aktion des Aufrufs, da ein veröffentlichter Aufruf den regulären Ablauf durchläuft und dieser sich selbst protokolliert. Hier wird protokolliert, was, von wo und mit welchem Schlüssel angefragt wurde.
Offen
Der Fortschritt wird nur in diesem Browser gespeichert – er wird nirgendwohin gesendet und ist für niemanden sonst einsehbar.