Zum Hauptinhalt springen
POST
Attestierung prägen
Dies ist die Sammlungsrouten-Variante der Bestätigungsprägung. Verwenden Sie die in „Ausprobieren“ gezeigte Option für strukturierte Datensätze oder kodierte Nutzdaten und behalten Sie denselben Idempotenz-Schlüssel bei, wenn Sie dieselbe Anfrage wiederholen. Verifizierungspakete und Datensatztypen bleiben im Anfrageschema wählbar.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Header

Idempotency-Key
string
erforderlich

Body

application/json

Wählen Sie „Strukturierter Datensatz“, um einen Datensatztyp auszuwählen und Ansprüche einzugeben, oder „Kodierte Nutzlast“, um vorhandene Bytes zu signieren. Kombinieren Sie niemals beide Eingabeformate.

alg
enum<string>
erforderlich

Muss dem ausgewählten Aussteller-Signaturschlüssel entsprechen.

Verfügbare Optionen:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
issuer_id
string<uuid>
erforderlich

Die UUID des Ausstellers, der die Attestierung erstellt

Beispiel:

"550e8400-e29b-41d4-a716-446655440000"

kid
string
erforderlich

Schlüsselbezeichner für den Signierschlüssel

Beispiel:

"es256-key-1"

schema
enum<string>
erforderlich

Datensatztyp für strukturierte Eingaben. Geben Sie Ansprüche an und lassen Sie payload_b64url weg. Dieses Label validiert die Wahrheit der Ansprüche nicht unabhängig.

Verfügbare Optionen:
verifiable-id,
passport,
drivers-license,
government-id,
self-sovereign-id,
employment-verification,
professional-role,
membership-card,
professional-certification,
license,
accreditation,
degree,
completion-cert,
course-credit,
transcript,
micro-credential,
training-completion,
medical-license,
dea-registration,
board-certification,
health-credential,
vaccination-record,
aml-kyc,
security-clearance,
sam-gov,
jurisdiction-approval,
attestation-of-will,
bank-verification,
credit-attestation,
income-verification,
skill-badge,
competency,
industry-cert,
product-authenticity,
chain-of-custody,
origin-verification,
custom,
attestation
Beispiel:

"verifiable-id"

claims
object
erforderlich

Strukturierte Datensatzfelder. Erforderlich mit Schema; kann nicht mit payload_b64url kombiniert werden.

Beispiel:
attestation_id
string
content_type
string

MIME-Typ der ursprünglichen Bytes, wie application/json, application/pdf oder image/png. Strukturierte Schema-/Anspruchseingaben erfordern application/json.

Beispiel:

"application/json"

document_hash
string

Optionaler hexadezimaler SHA-256-Dokument-Hash. Ein eingebetteter claims.document.sha256 hat Vorrang; andernfalls wird dieses Feld verwendet, dann der dekodierte Nutzlast-Hash.

pack_id
string<uuid>

Optionale UUID des Workspace-Verifizierungspakets. Verwenden Sie „Verifizierungspakete auflisten“ mit demselben API-Schlüssel, um ein vorhandenes aktives Paket auszuwählen; lassen Sie es für einen eigenständigen Datensatz weg.

expires_at_unix
integer<int64>

Optionaler zukünftiger Unix-Zeitstempel in Sekunden für strukturierte Schema-/Anspruchseingaben. Er ist in der signierten JSON-Nutzlast enthalten. Für die Eingabe payload_b64url lassen Sie dieses Anforderungsfeld weg und betten expires_at_unix stattdessen an der Wurzel der genauen JSON-Nutzlast ein. Das Ablaufdatum kann nicht nachträglich geändert werden.

Erforderlicher Bereich: 1 <= x <= 253402300799
recipient_email
string<email>

Optionaler Empfänger für asynchrone Benachrichtigungen nach dem Prägen. Eine erfolgreiche Prägeantwort bestätigt die Zustellung nicht.

Antwort

Bestätigung geprägt

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
Verfügbare Optionen:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>