Passer au contenu principal
POST
Émettre un reçu
Crée un événement de reçu signé cryptographiquement et ancré dans le journal de transparence. Les reçus sont validés par rapport au schéma de type de reçu enregistré avant la signature.

Types de reçus

En-têtes

Réponse

string
UUID du reçu créé.
string
Le nom du type de reçu.
string
active
string
UUID de l’émetteur signataire.
string
Identifiant du sujet.
object
Signature cryptographique : alg, kid, value.
string
Horodatage ISO 8601.

Événement de webhook

Un événement de webhook receipt.created est livré à tous les points de terminaison configurés après une frappe réussie.

Autorisations

X-API-Key
string
header
requis

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

En-têtes

Idempotency-Key
string
requis

UUID pour la frappe idempotente

Corps

application/json
issuer_id
string
requis

UUID de l'émetteur signant le reçu

kid
string
requis

ID de clé de la clé de signature

payload
any
requis

Charge utile du reçu validée par rapport au schéma

receipt_type
string
requis

Nom du type de reçu

subject
string
requis

Identifiant du sujet

alg
enum<string>

Algorithme de signature correspondant à la clé.

Options disponibles:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
metadata
any

Métadonnées optionnelles

receipt_version
string
retention_policy
string

Réponse

Reçu créé

receipt_id
string
receipt_type
string
status
string
issuer_id
string
subject
string
signature
object
issued_at
string