§ Entwickler
Signaturen, Siegel und Zeitstempel mit wenigen Zeilen Code.
Eine REST-API mit vorhersehbarem Verhalten, vollständiger Dokumentation und Beispielen in den wichtigsten Programmiersprachen.
§ 01 — Schnellstart
Ihr erstes gesiegeltes Dokument in drei Schritten.
01
API-Schlüssel erhalten
Erstellen Sie ein Konto und generieren Sie anschließend einen Schlüssel in Ihrem Dashboard. Bewahren Sie ihn serverseitig in einer Umgebungsvariablen auf: Er darf niemals in Code stehen, der im Browser ausgeführt wird.
export DOCACERT_API_KEY="ihr-testschluessel"
02
Erstes Dokument senden
Senden Sie die Datei und die gewünschten Optionen. Die Antwort enthält die ID des Vorgangs und den Status des Dokuments.
cURL
curl https://api.docacert.com/v1/seals \
-H "Authorization: Bearer $DOCACERT_API_KEY" \
-F "file=@rechnung-2026-0418.pdf" \
-F "timestamp=true"Node.js
import { openAsBlob } from "node:fs";
const form = new FormData();
form.append("file", await openAsBlob("rechnung-2026-0418.pdf"), "rechnung-2026-0418.pdf");
form.append("timestamp", "true");
const res = await fetch("https://api.docacert.com/v1/seals", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.DOCACERT_API_KEY}` },
body: form,
});
const seal = await res.json();Python
import os
import requests
with open("rechnung-2026-0418.pdf", "rb") as f:
res = requests.post(
"https://api.docacert.com/v1/seals",
headers={"Authorization": f"Bearer {os.environ['DOCACERT_API_KEY']}"},
files={"file": f},
data={"timestamp": "true"},
)
seal = res.json()C#
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
"Bearer", Environment.GetEnvironmentVariable("DOCACERT_API_KEY"));
using var form = new MultipartFormDataContent
{
{ new StreamContent(File.OpenRead("rechnung-2026-0418.pdf")), "file", "rechnung-2026-0418.pdf" },
{ new StringContent("true"), "timestamp" }
};
var res = await http.PostAsync("https://api.docacert.com/v1/seals", form);
var seal = await res.Content.ReadFromJsonAsync<Seal>();Antwort · 201
{
"id": "seal_8f2c41d0e7",
"status": "sealed",
"format": "PAdES-B-LT",
"timestamp": "2026-10-13T09:41:27Z",
"sha256": "9b1f04…a2c07e"
}03
Ergebnis verfolgen
Laden Sie das zertifizierte Dokument herunter oder abonnieren Sie Webhooks, um über jeden Schritt informiert zu werden. Prüfen Sie stets die Signatur der empfangenen Benachrichtigungen.
{
"type": "seal.completed",
"created_at": "2026-10-13T09:41:29Z",
"data": {
"id": "seal_8f2c41d0e7",
"status": "sealed"
}
}
§ 02 — API-Grundsätze
Konventionen, die Sie bereits kennen.
REST und JSON
Klar benannte Ressourcen, übliche HTTP-Methoden und JSON-Antworten.
OpenAPI-Spezifikation
Generieren Sie Ihren Client oder importieren Sie die API anhand der öffentlichen Spezifikation in Ihre Werkzeuge.
Testumgebung
Entwickeln und testen Sie mit einem eigenen Schlüssel, getrennt von der Produktion.
Signierte Webhooks
Jede Benachrichtigung ist signiert: Prüfen Sie ihre Echtheit, bevor Sie sie verarbeiten.
Eindeutige Fehler
Konsistente HTTP-Statuscodes und ausführliche Fehlermeldungen, damit Sie Probleme schnell beheben.
Audit-Trail
Jeder Vorgang wird protokolliert und ist exportierbar – für Ihre internen Kontrollen und für Ihre Prüfer.
§ 03 — Ressourcen
Alles für eine reibungslose Integration.
Dokumentation
Anleitungen, Konzepte und bewährte Vorgehensweisen – vom ersten Aufruf bis zur Produktion.
API-Referenz
Alle Endpunkte mit ihren Parametern und Antworten, mit Beispielen.
Technischer Support
Eine Frage zu Ihrer Integration? Schreiben Sie unserem technischen Team.
§ Loslegen
Bereit, Ihr erstes Dokument zu senden?
Holen Sie sich Ihren API-Schlüssel und führen Sie Ihre ersten Aufrufe in der Testumgebung aus.