API und Webhooks: Dieselbe Vertrauenskette, außerhalb der App

Eine Zahl, die innerhalb einer App vertrauenswürdig ist und in dem Moment unverifizierbar wird, in dem sie diese verlässt, ist nicht wirklich vertrauenswürdig – sie sieht nur so aus, solange jemand zusieht. Rexfins programmatische Schnittstelle ist um eine Regel herum gebaut: Alles, was eine Zahl auf dem Bildschirm beweisen kann, beweist sie identisch, sobald sie über die API, einen Webhook oder einen strukturierten Export abgerufen wird. Nichts wird auf dem Weg nach draußen sauberer gewaschen, als es ist.

Was jede Zahl auf dem Weg nach draußen mitträgt

Jeder Wert, den die API oder ein Webhook ausgibt, kommt in demselben Umschlag: seine Währung und Einheitenskalierung, ob es sich um eine Ist-Zahl oder eine modellierte Zahl handelt, und – entscheidend – ein Beleg-Handle, aber nur dann, wenn es sich um eine Ist-Zahl handelt. Eine modellierte Projektion wird nie mit einem angehängten Beleg ausgegeben, weil sie sich auch innerhalb der App nie einen verdient. Ist der Zugriffstoken eines Aufrufers nicht auf das zugrunde liegende Quelldokument berechtigt, löst sich der Beleg schlicht nicht auf – eine fail-closed „eingeschränkt”-Antwort, keine abgespeckte Version des Originals. Das Schema selbst macht die Unterscheidung zwischen Ist-Zahl und modellierter Zahl unumgehbar: Ein integrierender Entwickler kann nicht versehentlich Code schreiben, der einen Forecast so behandelt, als wäre er eine eingereichte Zahl, weil das Feld, das den Beleg tragen würde, dort schlicht nicht existiert.

Eine dokumentierte, versionierte REST-API

Die REST-Schicht ist eine per OpenAPI beschriebene, versionierte, überwiegend lesende Oberfläche: Statements, einzelne Zellen, benannte Szenarien, das aktuelle Verifizierer-Urteil für ein Modell, und der Unterschied zwischen einer Version und der letzten. Sie ist bewusst überwiegend lesend gestaltet – nichts an dieser Schnittstelle erlaubt es einem externen Aufrufer, eine Zelle oder einen Treiber in Ihr Modell zurückzuschreiben, denn diese Befugnis bleibt innerhalb der App, wo der Audit-Trail nachverfolgt, wer was geändert hat. Der Zugriff läuft über OAuth/OIDC und begrenzte Tokens, und die effektive Reichweite jedes Tokens ist auf das Engere begrenzt aus dem, wofür der Token berechtigt wurde, und dem, was die Zugriffskontrollen der anfragenden Person selbst erlauben – ein Token kann nie mehr sehen, als der Mensch, der ihn ausgestellt hat, sehen konnte, und verliert jemand mitten in einer Sitzung den Zugriff, wird der Token sofort gekappt, nicht erst bei seiner nächsten Erneuerung.

Webhooks: benachrichtigt, nicht abgefragt

Statt die API nach einem Zeitplan zu bombardieren, registriert sich ein Abonnent für die Ereignisse, die zählen – eine Periode, die abschließt, ein Board-Pack, das fertiggestellt wird, eine Version, die veröffentlicht wird, oder das Verifizierer-Gate, das bei einem Exportversuch besteht oder scheitert. Jede Zustellung ist signiert, sodass ein Empfänger bestätigen kann, dass sie tatsächlich von Rexfin kam, und wird mindestens einmal mit einer stabilen Ereignis-ID zugestellt, sodass ein Duplikat erkennbar ist, statt still doppelt verarbeitet zu werden. Ein Abonnenten-Endpunkt, der nicht erreichbar ist, wird mit Backoff erneut versucht, nicht endlos bombardiert, und vergangene Zustellungen bleiben gelistet und wiederholbar, falls Sie eine erneut abrufen müssen. Ein verifier.failed-Webhook insbesondere ist dasselbe „dieses Modell darf nicht exportiert werden”-Signal, das die App intern zeigt – hinausgetragen zu jeder nachgelagerten Pipeline, die davon wissen muss, ohne dass jemand zuerst in der Oberfläche nachsehen müsste.

Strukturierte Exporte, die nur abgehen, wenn das Modell aufgeht

Neben dem menschenlesbaren Board-Pack kann Rexfin maschinenlesbare Exporte erzeugen – iXBRL, verschlagwortet mit derselben Taxonomie, die die Statements verwenden, plus flaches JSON und CSV – für die Weiterverarbeitung durch einen Regulator, ein Börsenmeldesystem oder eine Konsolidierungspipeline. Diese Exporte sind exakt so gesperrt, wie das Board-Pack gesperrt ist: Ein unausgeglichenes, nicht abgestimmtes Modell kann keinen erzeugen. Ein strukturierter Export eines Modells, das nicht aufgeht, ist genau das Versagen, das diese gesamte Disziplin verhindern soll – also gilt das Gate auch hier, nicht nur für das Dokument, das ein Mensch liest.

Für wen das gemacht ist

Das ist für Teams, die bereits einen BI-Stack, ein Konsolidierungssystem oder eine interne Pipeline haben und wollen, dass Rexfins Zahlen dort hineinfließen, ohne dass jemand ein Board-Pack in eine Tabelle zurücktippt – und für alle, die brauchen, dass ein nachgelagertes System sofort weiß, wenn ein Modell aufgeht oder nicht aufgeht. Besteht Ihr Integrationsplan aktuell darin, dass jemand ein PDF exportiert und neu eintippt, ersetzt die API das durch einen dokumentierten Vertrag, der dieselben Garantien trägt wie die App.

Für die agentenseitige Variante derselben Schnittstelle sehen Sie, wie MCP-Zugriff dieselben Regeln auf KI-Copiloten ausdehnt, oder starten Sie beim Produkttour-Hub für das Gesamtbild.