Passer au contenu principal
POST
Émettre une attestation
Ceci est la variante de frappe d’attestation de la route de collection. Utilisez l’option d’enregistrement structuré ou de charge utile encodée affichée dans Try It et conservez la même clé d’idempotence lors de la nouvelle tentative de la même requête. Les packs de vérification et les types d’enregistrement restent sélectionnables dans le schéma de requête.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

En-têtes

Idempotency-Key
string
requis

Corps

application/json

Choisissez Enregistrement structuré pour sélectionner un type d'enregistrement et saisir des revendications, ou Charge utile encodée pour signer des octets existants. Ne combinez jamais les deux formats d'entrée.

alg
enum<string>
requis

Doit correspondre à la clé de signature de l'émetteur sélectionnée.

Options disponibles:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
issuer_id
string<uuid>
requis

L'UUID de l'émetteur créant l'attestation

Exemple:

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

kid
string
requis

Identifiant de clé pour la clé de signature

Exemple:

"es256-key-1"

schema
enum<string>
requis

Type d'enregistrement pour l'entrée structurée. Fournissez des revendications et omettez payload_b64url. Cette étiquette ne valide pas indépendamment la véracité des revendications.

Options disponibles:
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
Exemple:

"verifiable-id"

claims
object
requis

Champs d'enregistrement structurés. Requis avec le schéma ; ne peut pas être combiné avec payload_b64url.

Exemple:
attestation_id
string
content_type
string

Type MIME des octets originaux, tel que application/json, application/pdf ou image/png. L'entrée de schéma/revendications structurée nécessite application/json.

Exemple:

"application/json"

document_hash
string

Hachage SHA-256 hexadécimal optionnel du document. Un claims.document.sha256 intégré a la priorité ; sinon, ce champ est utilisé, puis le hachage de la charge utile décodée.

pack_id
string<uuid>

UUID optionnel du pack de vérification de l'espace de travail. Utilisez la liste des packs de vérification avec la même clé API pour sélectionner un pack actif existant ; omettez pour un enregistrement autonome.

expires_at_unix
integer<int64>

Horodatage Unix futur optionnel en secondes pour l'entrée de schéma/revendications structuré. Il est inclus dans la charge utile JSON signée. Pour l'entrée payload_b64url, omettez ce champ de requête et intégrez plutôt expires_at_unix à la racine de la charge utile JSON exacte. L'expiration ne peut pas être modifiée sur place.

Plage requise: 1 <= x <= 253402300799
recipient_email
string<email>

Destinataire optionnel pour une notification asynchrone après la frappe. Une réponse de frappe réussie ne confirme pas la livraison.

Réponse

Attestation émise

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
Options disponibles:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>