Passer au contenu principal
Une entreprise émet d’abord une attestation signée, puis fournit une référence à un consommateur. La livraison n’émet pas l’attestation, ne vérifie pas ses revendications et ne rend pas les enregistrements privés publics.

1. Mint

Suivez le guide de démarrage rapide en utilisant l’émetteur et la clé de signature de l’espace de travail de l’entreprise. Fournissez les revendications de l’application via une entrée structurée schema et claims, ou encodez les octets originaux exacts en tant que payload_b64url. Ne combinez pas les deux modes. Conservez le attestation_id retourné ; ne substituez pas un identifiant att_ inventé là où l’API requiert un UUID.

2. Livrer

Utilisez Livrer à la boîte de réception avec attestation_id, l’e-mail du destinataire dans consumer_reference, et safe_metadata facultatif. Utilisez une accréditation d’émetteur pour l’espace de travail propriétaire de l’attestation. HTTP 201 enregistre la livraison dans une boîte de réception de consommateur existante. HTTP 202 avec status: pending et reason: consumer_not_registered enregistre une livraison en attente. Aucune de ces réponses ne prouve qu’un e-mail a atteint le destinataire. Évitez les affirmations sensibles dans les métadonnées d’affichage.

3. Lire la boîte de réception

Le consommateur s’authentifie séparément et utilise Inbox. read_state accepte UNREAD, READ, ARCHIVED ou ALL. Une clé d’entreprise ne doit pas être utilisée comme identité du consommateur. La livraison dans la boîte de réception et la visibilité du portefeuille public sont distinctes. Ne supposez pas qu’un élément de la boîte de réception a été partagé publiquement simplement parce que la livraison a réussi.

4. Vérifier

Utilisez Vérifier avec l’ID d’attestation, et éventuellement la charge utile encodée originale ou le hachage du document. Ce point de terminaison n’accepte pas de champ proof_bundle en base64. Inspectez le verdict et les raisons plutôt que le seul statut HTTP. Pour les preuves hors ligne, suivez la spécification du bundle de preuves. La validation cryptographique hors ligne nécessite des clés publiques fiables et ne peut pas établir l’état de révocation actuel sans informations d’état récentes. Ni la vérification de signature en ligne ni hors ligne ne prouve que l’affirmation sous-jacente du monde réel est vraie.