API-Dokumentation

Stonewake API

Die Stonewake API bietet lesenden programmatischen Zugriff auf die Inhalte Ihres Stonewake-Arbeitsbereichs: Portfolio-Monitoring, Risiko je Unternehmen sowie Gegenpartei- und Länderinformationen für Teams der Exportfinanzierung.

Antworten sind reines JSON über HTTPS. Die API ist von Grund auf nur lesend ausgelegt: Kein Endpunkt legt in Ihrem Arbeitsbereich etwas an, ändert etwas oder löscht etwas.

text
Base URL: https://api.stonewake.ai

Wer Zugang erhält

Die API steht Kunden von Stonewake nach Vereinbarung zur Verfügung. Der Zugang wird je Arbeitsbereich von Stonewake freigeschaltet; danach legt eine Administratorin oder ein Administrator des Arbeitsbereichs die API-Schlüssel im Dashboard selbst an und verwaltet sie. Um den Zugang für Ihren Arbeitsbereich zu vereinbaren, wenden Sie sich an Ihre Ansprechperson bei Stonewake oder schreiben Sie an contact@stonewake.ai.

Für Entwicklerinnen, Entwickler und KI-Agenten gebaut

Die API ist darauf ausgelegt, von Software bedient zu werden, ob diese Software von Hand geschrieben oder von einem KI-Agenten gesteuert wird. Antworten verwenden stabile Feldnamen, und Ablehnungen tragen maschinenlesbare Fehlercodes statt Fließtext, den man erst auswerten müsste. Auch diese Dokumentation ist maschinenlesbar: Jede Seite wird zusätzlich als reines Markdown ausgeliefert, unter ihrem Pfad plus .md oder über den Header Accept: text/markdown. Daneben stehen im Wurzelverzeichnis der Website llms.txt (ein einzeiliger Index jeder Seite) und llms-full.txt (alle Seiten in einer Markdown-Datei). Die Unternehmensseite funktioniert genauso: Jede öffentliche Seite auf stonewake.ai wird ebenfalls als Markdown ausgeliefert, und stonewake.ai/llms.txt sagt, wann Stonewake einzusetzen ist und wie es aufgerufen wird. Wenn Sie einen Agenten anbinden: Der Schnellstart endet mit einem Block, den Sie direkt in dessen Kontext einfügen können, und MCP-fähige Assistenten überspringen HTTP ganz und verbinden sich über MCP.

Inhalt

  • Schnellstart: vom Schlüssel zur ersten Antwort in fünf Minuten.
  • Authentifizierung: Bearer-Schlüssel, das Format swk_live_ und die Regeln im Umgang damit.
  • Schlüssel und Zugangsverwaltung: Schlüssel anlegen, auflisten und widerrufen.
  • API-Referenz: jeder aktive /v1-Endpunkt, Paginierung und das Verhalten der Antworten.
  • MCP: Claude, Cursor oder einen beliebigen MCP-Client mit Ihrem Arbeitsbereich verbinden.
  • Fehler und Anfragebegrenzungen: Statuscodes, Fehler-Bodys und die Obergrenzen für Anfragen.
  • API-Sicherheit: das Sicherheitskonzept der API, die Rolle von KI und der Weg für Sicherheitsmeldungen.
  • Nutzungsbedingungen: wofür der Zugang genutzt werden darf und welche Pflichten für die Daten gelten.

Für Ihre IT- und Sicherheitsprüfung