Eine Bestätigung ist eine signierte Erklärung eines Ausstellers. Eine nützliche Integration verwaltet den gesamten Lebenszyklus: was signiert wird, wie Empfänger es überprüfen, wie die Beweismittel geteilt werden und was passiert, wenn die Erklärung nicht mehr vertrauenswürdig sein sollte.
Den Datensatz definieren, bevor die API aufgerufen wird
Wählen Sie eine stabile Geschäftsreferenz, den für die Erklärung verantwortlichen Aussteller und die für den Workflow erforderliche Mindestnutzlast. Verwenden Sie das unterstützte Schema und die genaue Kodierung, die für Ihre API-Version dokumentiert sind. Improvisieren Sie keine Signaturformate aus einem visuellen Zertifikat oder einem alten Codebeispiel.
Für einen Kursabschlussnachweis könnten wichtige Felder eine Kursreferenz und genehmigte Abschlussdetails umfassen. Die Institution entscheidet, was die Aussage bedeutet. Truthlocks signiert und verwaltet den Nachweis innerhalb des konfigurierten Ausstellungs-Workflows.
Ergebnis ausgeben und aufbewahren
Verwenden Sie die korrekte ausstellende Identität und den konfigurierten Signierschlüssel. Speichern Sie den zurückgegebenen Datensatz-Identifikator und die Beweismittel, die Ihre Anwendung für spätere Überprüfungen benötigt. Behandeln Sie Validierungs-, Berechtigungs- und Dienstfehler explizit. Wenn eine Ausstellungsanfrage ein Timeout hat, stellen Sie fest, ob ein Datensatz erstellt wurde, bevor Sie einen Schreibvorgang wiederholen.
Überprüfen Sie das tatsächliche Idempotenzverhalten des Endpunkts und der von Ihnen verwendeten SDK-Version. Eine Wiederholungsgrenze allein stellt nicht sicher, dass das Wiederholen eines Schreibvorgangs keine doppelten Geschäftsereignisse erzeugen kann.
Vor der Präsentation einer Schlussfolgerung prüfen
Verifizieren Sie den unterstützten Datensatz unter Verwendung der entsprechenden Public-Key-Informationen. Halten Sie die Signaturintegrität, den Ausstellerkontext und den aktuellen Status als separate Teile des Ergebnisses sichtbar. Wenn die Verifizierung nicht verfügbar ist, sagen Sie dies und geben Sie dem Benutzer einen Wiederholungs- oder Überprüfungspfad, anstatt ein erfolgreiches Abzeichen anzuzeigen.
Änderungen teilen und verwalten
Ein Verifizierungslink gibt Empfängern einen Weg zur aktuellen Prüfung. Ein unterstützter Nachweispaket kann Signaturen, Schlüssel und verfügbare Protokollnachweise zur unabhängigen Prüfung enthalten. Offline-Nachweise können keinen Widerruf melden, der nach der Erstellung des Pakets erfolgte.
Definieren Sie, wer einen Datensatz widerrufen kann und wann eine korrigierte Erklärung eine neue Ausstellung erfordert. Testen Sie einen widerrufenen Datensatz und eine geänderte Nutzlast, bevor Sie den Erfolgspfad in Ihre Benutzeroberfläche integrieren.
Basierend auf aktueller Dokumentation erstellen
Verwenden Sie die aktuelle API-Dokumentation und die Methodensignaturen Ihres installierten SDKs. Beginnen Sie mit der Beispiel für Kursabschluss oder Genehmigungsdatensatz-Workflow, passen Sie dann die Felder und Genehmigungsverantwortlichkeiten an Ihr System an.
