Zertifizierung digitaler Inhalte über die API automatisieren

Schritt 1 — Einen API-Schlüssel erstellen

Melden Sie sich an, gehen Sie zu Entwickler → API-Schlüssel und klicken Sie auf API-Schlüssel erstellen. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt.

Schritt 2 — Ein Zertifikat erstellen

Senden Sie eine POST-Anfrage mit Ihrer URL:

curl -X POST https://secure.instantproof.legal/api/v1/certificates \
  -H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/page-to-certify"}'

Antwort 201 Created:

{
  "certificateId": "abc123…",
  "recordingId":   "def456…",
  "url":           "https://example.com/page-to-certify",
  "finalUrl":      "https://example.com/page-to-certify",
  "status":        "ready",
  "links": {
    "self":        "/api/v1/certificates/def456…",
    "certificate": "/api/v1/certificates/def456…/download"
  }
}

Schritt 3 — Das PDF-Zertifikat herunterladen

Folgen Sie der URL links.certificate mit Ihrem API-Schlüssel. Der Server gibt eine 302-Weiterleitung zu einer vorsignierten Download-URL zurück:

curl -L \
  -H "Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx" \
  "https://secure.instantproof.legal/api/v1/certificates/def456…/download" \
  -o certificate.pdf

Das heruntergeladene PDF ist dasselbe signierte PDF-Zertifikat, das die Weboberfläche erzeugt, und kann unter /de/certificate.html überprüft werden.

Alle API-Anfragen müssen Folgendes enthalten:

Authorization: Bearer ip_live_xxxxxxxxxxxxxxxx

Schlüssel werden unter Einstellungen → Entwickler → API-Schlüssel erstellt. Ein Schlüssel authentifiziert sich als Ihr Konto — behandeln Sie ihn wie ein Passwort. Widerrufen Sie ihn sofort, falls er offengelegt wird.

Schlüssel für Live-Konten beginnen mit dem Präfix ip_live_. Das Präfix hilft Ihnen, sie im Code oder in Umgebungsdateien zu erkennen.

Python

import requests

API_KEY = "ip_live_xxxxxxxxxxxxxxxx"
BASE    = "https://secure.instantproof.legal"

# Ein Zertifikat erstellen
resp = requests.post(
    f"{BASE}/api/v1/certificates",
    json={"url": "https://example.com"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
resp.raise_for_status()
data = resp.json()
recording_id = data["recordingId"]

# Das PDF herunterladen
pdf = requests.get(
    f"{BASE}/api/v1/certificates/{recording_id}/download",
    headers={"Authorization": f"Bearer {API_KEY}"},
    allow_redirects=True,
)
pdf.raise_for_status()
with open("certificate.pdf", "wb") as f:
    f.write(pdf.content)
print(f"Certificate saved ({len(pdf.content)} bytes)")

Node.js (fetch)

const API_KEY = process.env.INSTANTPROOF_API_KEY;
const BASE    = "https://secure.instantproof.legal";

// Ein Zertifikat erstellen
const res = await fetch(`${BASE}/api/v1/certificates`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com" }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { recordingId, links } = await res.json();

// Das PDF herunterladen
const pdf = await fetch(`${BASE}${links.certificate}`, {
  headers: { "Authorization": `Bearer ${API_KEY}` },
  redirect: "follow",
});
const buffer = Buffer.from(await pdf.arrayBuffer());
require("fs").writeFileSync("certificate.pdf", buffer);

Shell (curl)

# Schlüssel setzen
export INSTANTPROOF_API_KEY="ip_live_xxxxxxxxxxxxxxxx"

# Erstellen
CERT=$(curl -sf -X POST https://secure.instantproof.legal/api/v1/certificates \
  -H "Authorization: Bearer $INSTANTPROOF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}')

echo "$CERT" | python3 -m json.tool

RECORDING_ID=$(echo "$CERT" | python3 -c "import sys,json; print(json.load(sys.stdin)['recordingId'])")

# Herunterladen
curl -sfL \
  -H "Authorization: Bearer $INSTANTPROOF_API_KEY" \
  "https://secure.instantproof.legal/api/v1/certificates/$RECORDING_ID/download" \
  -o certificate.pdf

ls -lh certificate.pdf