§ 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.