Une attestation est une déclaration signée d'un émetteur. Une intégration utile gère l'ensemble du cycle de vie : ce qui est signé, comment les destinataires le vérifient, comment la preuve est partagée et ce qui se passe lorsque la déclaration ne doit plus être fiable.
Définir l'enregistrement avant d'appeler l'API
Choisissez une référence commerciale stable, l'émetteur responsable de la déclaration et la charge utile minimale requise pour le flux de travail. Utilisez le schéma pris en charge et l'encodage exact documentés pour votre version d'API. N'improvisez pas les formats de signature à partir d'un certificat visuel ou d'un ancien exemple de code.
Pour un relevé de fin de cours, les champs importants peuvent inclure une référence de cours et les détails de fin de cours approuvés. L'institution décide de la signification de la déclaration. Truthlocks signe et gère le relevé dans le cadre du flux de travail d'émission configuré.
Émettre et conserver le résultat
Utilisez l'identité d'émission correcte et la clé de signature configurée. Stockez l'identifiant d'enregistrement retourné et les preuves dont votre application a besoin pour des vérifications ultérieures. Gérez explicitement les erreurs de validation, d'autorisation et de service. Si une demande d'émission expire, déterminez si un enregistrement a été créé avant de réessayer une écriture.
Vérifiez le comportement d'idempotence réel du point de terminaison et de la version du SDK que vous utilisez. Une limite de tentatives seule n'établit pas que la répétition d'une écriture ne peut pas créer d'événements commerciaux en double.
Vérifier avant de présenter une conclusion
Vérifiez l'enregistrement pris en charge à l'aide des informations de clé publique appropriées. Gardez l'intégrité de la signature, le contexte de l'émetteur et le statut actuel visibles comme des parties distinctes du résultat. Si la vérification n'est pas disponible, indiquez-le et donnez à l'utilisateur un chemin de réessai ou de révision plutôt que d'afficher un badge de succès.
Partager et gérer les changements
Un lien de vérification donne aux destinataires un chemin vers la vérification actuelle. Un lien pris en charge ensemble de preuves peut contenir des signatures, des clés et des preuves de journal disponibles pour une inspection indépendante. Les preuves hors ligne ne peuvent pas signaler une révocation survenue après la création du package.
Définissez qui peut révoquer un enregistrement et quand une déclaration corrigée nécessite une nouvelle émission. Testez un enregistrement révoqué et une charge utile modifiée avant d'intégrer le chemin de succès dans votre interface utilisateur.
Construire à partir de la documentation actuelle
Utilisez le documentation API actuelle et les signatures de méthode de votre SDK installé. Commencez par le exemple d'achèvement de cours ou flux de travail d'enregistrement des permis, puis adaptez les champs et les responsabilités d'approbation à votre système.
