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éeschema 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 avecattestation_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 champproof_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.
