Zum Hauptinhalt springen
Ein Unternehmen prägt zunächst eine signierte Bestätigung und liefert dann einen Verweis an einen Verbraucher. Die Lieferung prägt die Bestätigung nicht, überprüft ihre Behauptungen nicht und macht private Aufzeichnungen nicht öffentlich.

1. Prägen

Folgen Sie dem Quickstart unter Verwendung des Ausstellers und Signaturschlüssels des Geschäftsbereichs. Geben Sie Anwendungsansprüche über strukturierte schema und claims Eingaben an oder kodieren Sie die exakten Originalbytes als payload_b64url. Kombinieren Sie nicht beide Modi. Behalten Sie die zurückgegebene attestation_id; ersetzen Sie keine erfundene att_ Kennung, wo die API eine UUID erfordert.

2. Liefern

Verwenden Sie An Posteingang liefern mit attestation_id, der E-Mail-Adresse des Empfängers in consumer_reference und optional safe_metadata. Verwenden Sie ein Aussteller-Anmeldeinformationen für den Arbeitsbereich, der die Bestätigung besitzt. HTTP 201 zeichnet die Zustellung an einen bestehenden Verbraucher-Posteingang auf. HTTP 202 mit status: pending und reason: consumer_not_registered zeichnet eine ausstehende Zustellung auf. Keine der beiden Antworten beweist, dass eine E-Mail den Empfänger erreicht hat. Vermeiden Sie sensible Angaben in den Anzeige-Metadaten.

3. Posteingang lesen

Der Verbraucher authentifiziert sich separat und verwendet Inbox. read_state akzeptiert UNREAD, READ, ARCHIVED oder ALL. Ein Geschäftsschlüssel darf nicht als Identität des Verbrauchers verwendet werden. Die Zustellung im Posteingang und die öffentliche Sichtbarkeit des Portfolios sind getrennt. Gehen Sie nicht davon aus, dass ein Posteingangselement öffentlich geteilt wurde, nur weil die Zustellung erfolgreich war.

4. Verifizieren

Verwenden Sie Verifizieren mit der Bestätigungs-ID und optional der ursprünglich kodierten Nutzlast oder dem Dokument-Hash. Dieser Endpunkt akzeptiert kein base64 proof_bundle Feld. Überprüfen Sie das Urteil und die Gründe anstatt nur den HTTP-Status. Für Offline-Beweise folgen Sie der Proof-Bundle-Spezifikation. Die Offline-Kryptovalidierung benötigt vertrauenswürdige öffentliche Schlüssel und kann den aktuellen Widerrufsstatus ohne aktuelle Statusinformationen nicht feststellen. Weder die Online- noch die Offline-Signaturprüfung beweist, dass die zugrunde liegende reale Behauptung wahr ist.