Schnellstart: Cindermark in 10 Minuten integrieren
Ein praktischer Leitfaden für Entwickler, um die Cindermark API zu implementieren und Ihre Dokumentenintegrität sofort zu gewährleisten.
Voraussetzungen
Bevor Sie mit der Integration beginnen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen, um einen reibungslosen Workflow zu garantieren:
- Ein aktives Cindermark Developer oder Enterprise Konto.
- Zugriff auf die Cindermark Developer Console (unter
dev.cindermark.io). - Grundkenntnisse in RESTful APIs und JSON-Datenstrukturen.
- Ein lokales Entwicklungsumfeld mit curl oder einem Tool wie Postman.
API-Key generieren
Der erste Schritt ist die Authentifizierung. Melden Sie sich in der Cindermark Console an und navigieren Sie zum Reiter "Einstellungen > API-Zugriff". Klicken Sie auf "Neuer Schlüssel erstellen".
Nennen Sie Ihren Schlüssel deskriptiv, z.B. dev-integration-main. Kopieren Sie den generierten Schlüssel sofort, da er aus Sicherheitsgründen nur einmal angezeigt wird.
Ersten Hash generieren
Um ein Dokument zu schützen, müssen Sie dessen Inhalt an unsere API senden. Cindermark berechnet den SHA-256 Hash serverseitig, um die Datenintegrität zu gewährleisten, bevor der Hash in der Blockchain verankert wird.
{
"filename": "vertragsentwurf_v2.pdf",
"file_data": "<base64-encoded-content>",
"metadata": {
"author": "Max Mustermann",
"department": "Legal"
}
}
Die Antwort enthält Ihre transaction_id und den document_hash. Speichern Sie diese Werte in Ihrer lokalen Datenbank, um sie später mit der Blockchain-Referenz zu verknüpfen.
Verifizierung testen
Das Herzstück von Cindermark ist die Unveränderbarkeit. Testen Sie nun, ob das Dokument manipuliert wurde. Senden Sie denselben Hash an den Verifizierungs-Endpoint.
Wenn Sie das Originaldokument erneut hochladen, erhalten Sie den Status VERIFIED. Ändern Sie auch nur ein einziges Bit im Dokument und wiederholen Sie den Prozess – das System wird den Status MODIFIED zurückgeben und die Integritätskette als unterbrochen markieren.
Nächste Schritte
Herzlichen Glückwunsch! Sie haben erfolgreich Ihre erste Verbindung zur Cindermark Blockchain hergestellt. In den nächsten Schritten sollten Sie sich mit der Fehlerbehandlung (Error Handling) und dem automatisierten Batch-Upload beschäftigen.
Webhooks einrichten
Erhalten Sie Echtzeit-Benachrichtigungen, sobald ein Hash in der Blockchain bestätigt wurde.
SDK Integration
Nutzen Sie unsere Bibliotheken für Python, Node.js und Java für eine schnellere Implementierung.
Support Forum
Tauschen Sie sich mit anderen Entwicklern aus und erhalten Sie Hilfe von unseren Experten.
Bereit für unveränderliche Beweise?
Starten Sie noch heute mit einer 14-tägigen Testphase. Keine Kreditkarte erforderlich für den Entwickler-Zugang.