Entwickler

Lesen Sie die öffentliche Prüf-API und testen Sie die institutionelle Prüfung danach gefahrlos in der Sandbox. Hier wird kein echter Eintrag erzeugt oder geändert.

Öffentliche Prüfung

Zwei Endpunkte brauchen keine Zugangsdaten. Schlagen Sie einen Eintrag per GTRN nach oder gleichen Sie einen SHA-256-Fingerabdruck ab. Die Antworten enthalten dieselbe öffentliche Registeransicht wie diese Website.

Eintrag nachschlagen

GET /v1/public/registry/{gtrn}

Fingerabdruck abgleichen

POST /v1/public/verify/fingerprint
content-type: application/json

{"fingerprint":"<64 hex characters, SHA-256>"}

Die Abfrage antwortet mit 200 und der Eintragsansicht, 404 wenn kein öffentlicher Eintrag passt, 410 wenn Prüfdaten nach Ablauf der Aufbewahrung entfernt wurden und 423 wenn die Offenlegung vorübergehend eingeschränkt ist.

Institutionelle Prüfung

Institutionen mit freigegebenen Zugangsdaten können Einträge prüfen, Artefakt-Fingerabdrücke vergleichen und signierte Prüfbelege erhalten. Den Zugang erteilt GTR. Die Sandbox verwendet nur synthetische Daten.

Webhooks und Einbettung

Webhook-Zustellung und einbettbare Prüfung für Institutionen und Partner sind in Vorbereitung. Die Sandbox kann ein signiertes Webhook-Ereignis simulieren; sie stellt nie eines zu.

Grenzen und Sicherheit

Legen Sie Zugangsdaten niemals in URLs ab. Zum Schutz des Dienstes können Nutzungsgrenzen gelten. Die Sandbox ist kein Produktivbetrieb und ihre Belege sind dauerhaft entsprechend gekennzeichnet.

Sandbox öffnen