1. Prägen
Folgen Sie dem Quickstart unter Verwendung des Ausstellers und Signaturschlüssels des Geschäftsbereichs. Geben Sie Anwendungsansprüche über strukturierteschema 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 mitattestation_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 base64proof_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.
