Zum Hauptinhalt springen
Audact
Angebot ansehen

API · Evidence Vault

Quittungen, abrufbar und nachrechenbar.

Öffentlicher API-Host: In Entwicklung

GET https://api.audact.ai/v1/receipts/{id}

Der öffentliche API-Host. Die Codebeispiele dokumentieren die vorgesehene Schnittstelle und die im aktuellen Produkt genutzten Endpunkte.

Auf diesem Host wird noch keine öffentliche API bereitgestellt, abgesehen von den veröffentlichten Merkle-Wurzeln unter /v1/metachain. Die im Produkt genutzten Endpunkte sind nicht dasselbe wie eine öffentliche API.

Warum dieser Status
Behauptung
In Entwicklung · Nur nach Bewerbung
Geltungsbereich
Der öffentliche API-Host. Die Codebeispiele dokumentieren die vorgesehene Schnittstelle und die im aktuellen Produkt genutzten Endpunkte.
Grundlage
Auf diesem Host wird noch keine öffentliche API bereitgestellt, abgesehen von den veröffentlichten Merkle-Wurzeln unter /v1/metachain. Die im Produkt genutzten Endpunkte sind nicht dasselbe wie eine öffentliche API.
Was er nicht feststellt
Dass ein einzelner Endpunkt heute funktioniert. Das wird je Endpunkt bestätigt, und die Bestätigung steht aus.
Was Sie heute bekommen
Der Produktionszugang liegt innerhalb eines geltenden bezahlten Vertrags. Endpunkte werden nicht separat bepreist.
Zuletzt geprüft
5. Oktober 2026
Wo Sie es prüfen
/apis

Produktivexport: Läuft heute · am 26. August 2026 nach dem Deploy nachgeprüftÖffentliche Prüfstelle: Noch nicht verfügbar

Alles, was die anderen fünf Endpunkte schreiben, landet hier. Quittungen werden zu einer Tageswurzel aggregiert, und die einzelne Quittung ist im Produkt sichtbar. Der Produktivexport einer Quittungsmenge – JSON für die Maschine, PDF für den Menschen – funktionierte bei der Nachprüfung am 26. August 2026 nach dem Deploy — fünf Anrufe, dreißig validierte Züge, dreißig Quittungen — gemessen an Browser-Anrufen statt über eine Telefonleitung. Was der Datensatz selbst trägt, bleibt unverändert: eine spätere Änderung oder Umsortierung ist durch Nachrechnen gegen das gespeicherte Commitment erkennbar. Das ist die Eigenschaft, und sie ist schwächer und ehrlicher als das Wort, zu dem die meisten Anbieter greifen.

GET /v1/receipts/{id}

{
  "receipt": {
    "receipt_format_version": "1.0.0",
    "call_id": "7f3c2a1e-0000-4000-8000-000000000000",
    "timestamp": "2026-08-15T10:14:23Z",
    "input_hash": "9b1d…e04a",
    "output_hash": "9b1d…e04a",
    "verdict": "ALLOW",
    "config_version": 12,
    "config_seal_hash": "4c2e…91d0",
    "policy_version": "DE_v1.1.0",
    "evidence_hash": "0b8e…7a13",
    "auth_mechanism": "hmac-sha256",
    "signature": "z3fx…c0de"
  }
}

Die Quittung, so wie sie die Engine ausstellt: JSON, kanonisiert wie auf /receipt-explorer beschrieben, bevor der HMAC-SHA256-Code unter einem von Audact verwahrten symmetrischen Schlüssel berechnet wird – keine Public-Key-Signatur. `receipt_format_version` benennt das Format, sodass eine ältere Quittung auch nach einer Änderung weiter prüfbar ist.

GET /v1/receipts?from=…&to=…

curl -G https://api.audact.ai/v1/receipts \
  -H "Authorization: Bearer $AUDACT_API_KEY" \
  -d from=2026-08-01 \
  -d to=2026-08-31 \
  -d jurisdiction=DE \
  -d format=pdf \
  -d bundle=true

Der Aufruf, den der Produktivexport nehmen wird, einer je Zeitraum und Rechtsraum. Der Export selbst funktionierte bei der Nachprüfung am 26. August 2026 nach dem Deploy: fünf Anrufe, dreißig validierte Züge, dreißig Quittungen, gemessen an Browser-Anrufen statt über eine Telefonleitung. Die Tageswurzeln sollen im Export mitreisen, ein Bündel lässt sich dann gegen sie nachrechnen; das sind die Wurzeln, die wir mitliefern; die Wurzeln sind unter api.audact.ai/v1/metachain veröffentlicht. Ein Export liefert die Quittungen, die zum angefragten Zeitraum und Rechtsraum passen. Er belegt nicht, dass jeder Anruf in diesem Zeitraum eine Quittung erzeugt hat.

Was Sie bekommen

Merkle-Aggregation: Quittungen werden zu Merkle-Wurzeln je Mandant aggregiert; die Wurzeln sind unter api.audact.ai/v1/metachain veröffentlicht, und der Bündelexport ist darauf ausgelegt, sie zu tragen.
Läuft heute
Zwei Exportformate aus einem Datensatz: JSON für die Maschine, PDF für den Menschen. Produktivexport einer Quittungsmenge. Der Export ist mit einer ECDSA-Signatur versiegelt; die Quittungen darin tragen ihr HMAC. Die öffentliche Schlüssel-URL im Umschlag löst noch nicht auf, daher kann eine Partei außerhalb der Plattform das Siegel heute nicht prüfen.
Läuft heute
Das monatliche Nachweispaket ist nicht im Angebot.
In Validierung
Aufbewahrungsfristen je Rechtsraum; kryptografische Löschung für den Rest folgt in Kürze.
In kontrollierten Tests
Beispielartefakte zum Ansehen, bevor Sie eine Zeile Code schreiben.
Läuft heute
Eine öffentliche Prüfstelle, für eine Gegenpartei ohne Konto.
Öffentliche Prüfstelle noch nicht verfügbar

Was trägt

Drei Felder, die jeder nachrechnen kann. Ohne Schlüssel, ohne Konto. Ein viertes, mit dem Einschlussnachweis aus dem Artikel-50-Bericht des Anrufs gegen die veröffentlichte Wurzel geprüft.

Der Hash der Eingabe, der Hash der Ausgabe und die Verkettung zur vorherigen Quittung lassen sich aus der Quittung selbst nachrechnen: ohne Schlüssel, ohne Konto. Diese drei nachzurechnen bedeutet: jede spätere Änderung oder Umsortierung ist durch Nachrechnen gegen das gespeicherte Commitment erkennbar. Der vierte, der Einschluss in der Merkle-Wurzel, wird mit dem Einschlussnachweis aus dem Artikel-50-Bericht des Anrufs gegen die veröffentlichte Wurzel geprüft; der Bericht trägt `event_inclusion_proof`, `cross_tenant_proof` und `merkle_root`, und `POST /v1/verify-inclusion` prüft einen Zweignachweis ohne Schlüssel.

Der Authentifizierungscode ist etwas anderes. Er ist HMAC-SHA256, berechnet mit einem von Audact verwahrten symmetrischen Schlüssel. Es ist keine digitale Signatur, und es gibt keinen öffentlichen Prüfschlüssel. Wer ihn prüfen kann, kann ihn auch erzeugen. Er authentifiziert; er ordnet nicht zu.

Aufbewahrung

So lange, wie der Rechtsraum es verlangt, und nicht länger.

Die Aufbewahrung wird je Rechtsraum gesetzt, weil die Antwort je Rechtsraum anders ausfällt. Fällt ein Datensatz aus seinem Fenster, wird der Schlüssel für die Nutzdaten vernichtet und der Ketteneintrag bleibt: Die Abfolge bleibt prüfbar, der Inhalt ist weg. Dieser Löschschritt folgt in Kürze. Genau das macht ein Löschverlangen nach Art. 17 DSGVO mit einer Nachweiskette überhaupt vereinbar.

Fragen

Kann eine Aufsichtsbehörde eine Quittung ohne Audact-Konto prüfen?
Die drei nachrechenbaren Felder ja: mit der Datei und einer Hash-Funktion. Das vierte, die Merkle-Zugehörigkeit, wird mit dem Einschlussnachweis aus dem Artikel-50-Bericht des Anrufs gegen die veröffentlichte Wurzel geprüft. Öffentliche Prüfstelle noch nicht verfügbar: die Wurzeln sind unter api.audact.ai/v1/metachain veröffentlicht, aber ein Dienst, der die Schritte für Sie übernimmt, existiert heute nicht, und ein Termin ist nicht zugesagt.
Was bringt das PDF gegenüber dem JSON?
Lesbarkeit, mehr nicht. Es trägt dieselben Felder aus demselben Datensatz, gesetzt für jemanden, der kein Terminal öffnen wird.
Was passiert mit der Kette nach einem Löschverlangen?
Der Eintrag bleibt, der Inhalt geht. Der Schlüssel, der die Nutzdaten entschlüsselt, wird dann vernichtet: Abfolge und Hashes passen weiter zusammen, die personenbezogenen Daten sind nicht wiederherstellbar. Dieser Löschschritt folgt in Kürze.

Sehen Sie sich zuerst das Beispielartefakt an

Eine Beispielquittung im Produktivformat: die Felder, die die Engine ausgibt, mit synthetischen Werten. Die Eingabe- und Ausgabetexte sind neben der Quittung enthalten, damit die Hashes nachgerechnet werden können; eine Produktivquittung enthält nur die Hashes.

Eine Kette selbst nachrechnen

Der Quittungs-Explorer nimmt eine Beispielkette und geht sie durch: Eingabe-Hash, Ausgabe-Hash, die Verkettung zur vorherigen Quittung und den Merkle-Pfad. In Ihrem Browser, ohne Konto.

Receipt Explorer öffnen

Verwandt