API-Dokumentation

Integrieren Sie Zertifikatsdaten direkt in Ihr ERP, Ihre Beschaffungssoftware oder eigene Anwendungen.

Kostenlos testen

Übersicht

Base URL

/api/v1

Authentifizierung

Bearer Token (API-Key)

Rate Limit

100 Anfr./Min. pro Org

Authentifizierung

API-Keys werden im Org-Admin-Bereich erstellt. Jeder Key hat das Format cw_... und kann über zwei Header-Optionen übergeben werden:

# Option 1: Authorization Header
Authorization: Bearer cw_abc123def456...

# Option 2: X-API-Key Header
X-API-Key: cw_abc123def456...

API-Keys werden serverseitig als SHA-256 Hash gespeichert. Der Klartext-Key wird nur einmal bei der Erstellung angezeigt — bewahren Sie ihn sicher auf.

Endpoint

GET/api/v1/certificate/{number}

Ruft den aktuellen Status eines Zertifikats ab. Das Zertifikat muss in der Organisation des API-Keys existieren.

Name

Name	Typ	Beschreibung
number	string (path)	Zertifikatsnummer, z.B. ISCC-EU-1234

Beispiel-Response (200)

{
  "cert_number": "ISCC-EU-1234",
  "status": "valid",
  "valid_until": "31.12.2026",
  "last_checked": "2026-02-12T08:30:00.000Z"
}

Note: Bei NIS-Zertifikaten (manuell erfasst) fehlt das Feld last_checked , da diese nicht automatisch geprüft werden.

Fehler-Responses

Status	Beschreibung
401	API-Key fehlt oder ungültig
404	Zertifikat nicht gefunden (in dieser Organisation)
429	Rate Limit überschritten (Retry-After Header beachten)

Beispiel mit curl

curl -H "Authorization: Bearer cw_YourApiKey..." \
  https://www.certificatewatch.com/api/v1/certificate/ISCC-EU-1234

Rate Limiting

Die API erlaubt 100 Anfragen pro Minute pro Organisation. Der aktuelle Verbrauch wird in den Response-Headern mitgeteilt:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
Retry-After: 42  (only on 429)

Bei Überschreitung des Limits erhalten Sie eine 429-Response. Warten Sie die im Retry-After Header (in Sekunden) angegebene Zeit ab, bevor Sie erneut anfragen.

API-Hinweis

Die API gibt den zuletzt bekannten Status basierend auf externen Quellen und/oder manueller Pflege aus. Keine Gewähr. Für verbindliche Aussagen bitte Originalquelle/Zertifikatsdokument prüfen. Siehe unsere Nutzungsbedingungen für Details.

API-Zugang erhalten

Kontaktieren Sie uns und erhalten Sie Ihren API-Key für die Integration in Ihre Systeme.

Kontakt aufnehmen