DACH
Sicherheitsdatenblatt (SDB) API: Überblick
Was die API kann, wie Sie Zugang bekommen und womit Sie rechnen müssen, bevor Sie sie in einen Prozess einbauen.
Letzte Aktualisierung: 2026-10-24
Was die API macht
Sie schicken ein SDB als PDF und erhalten einen strukturierten Datensatz mit einem Schlüssel je SDB-Abschnitt, dazu einen Konfidenzwert (confidence_score) und Warnungen (warnings). Dieselben Daten kommen als JSON, XML und CSV in einer Antwort.
Endpunkte
| Zweck | Endpunkt | Hinweis |
|---|---|---|
| Ein Dokument | POST /extract-sds | Multipart-Upload, Antwort sofort. |
| Mehrere Dokumente | POST /extract-sds/bulk | Bis zu 10 Dateien, Antwort 202 mit Auftragsnummer; Idempotency-Key möglich. |
| Auftragsstatus | GET /extract-sds/bulk/{jobId} | Status und Ergebnisse je Datei; optional signierter Webhook über callback_url. |
| KI-Assistenten | /mcp | MCP-Server mit denselben Funktionen. |
Zugang
| Stufe | Zugang | Für wen |
|---|---|---|
| Beispiel-Upload | Kostenlos auf der Startseite, kein Schlüssel nötig. | Erste Tests mit eigenen Dokumenten. |
| Self-Serve | Eigener API-Schlüssel nach der Anmeldung, nutzungsabhängig abgerechnet. | Teams, die selbst integrieren. |
| Enterprise | Dediziertes Deployment mit eigener Basis-URL, SLA und Datenresidenz nach Vertrag. Kontakt. | Große oder regulierte Programme. |
Aufbau der Antwort
Gekürzte, beispielhafte Struktur; ... steht für Text aus dem Dokument:
{
"ok": true,
"request_id": "2f6c1a54-7b0e-4d0a-9d52-6a1f0f3c9b11",
"confidence_score": 0.94,
"document_language": "en",
"warnings": [],
"outputs": {
"json": {
"product_identification": { "product_name": "...", "supplier_name": "..." },
"hazards_identification": { "ghs_classification": ["..."], "signal_word": "...", "h_statements": ["H225 ..."] },
"composition": [ { "substance_name": "...", "cas_number": "67-64-1", "concentration_percent": "95-100" } ],
"transport_information": { "un_number": "UN1090", "hazard_class": "3", "packing_group": "II" }
},
"xml": "<?xml version=...>",
"csv": "field,value ..."
}
}Standardlimits
Dies sind die Standardwerte auf dem gemeinsamen, gehosteten Endpunkt; Limits für Self-Serve und Enterprise legt Ihr Tarif fest.
| Limit | Standardwert |
|---|---|
| Dateien je Stapelauftrag | 10 |
| Dateigröße | 10 MB je Datei, 40 MB je Auftrag |
| Stapelaufträge | 20 je 24 Stunden |
Einzelabfragen (/extract-sds) | 100 je 24 Stunden |
Fehler
| Status | Code | Bedeutung |
|---|---|---|
400 | unsupported_file_type, missing_file | Datei fehlt oder ist kein gültiges PDF. |
401 | unauthorized | Schlüssel fehlt oder ist ungültig. |
413 | file_too_large | Datei oder Auftrag überschreitet das Größenlimit. |
429 | rate_limited | Limit erreicht; die Wartezeit steht im Header Retry-After. |
500, 502 | output_processing_failed, provider_error | Serverseitiger Fehler; erneut versuchen. Die request_id hilft dem Support. |
Mehrsprachig
Die API liest SDB-PDFs in der Sprache, in der das Dokument verfasst ist. Optional unterstützt language_hint (zum Beispiel de) die Auslegung. Die Feldnamen der Antwort sind immer dieselben englischen Schlüssel; H- und P-Sätze, CAS- und UN-Nummern sind sprachunabhängig. Prüfen Sie Freitextfelder gegen das Originaldokument: Konfidenzwert und Warnungen zeigen, wann eine Prüfung nötig ist. Wir veröffentlichen keine Genauigkeitswerte pro Sprache; validieren Sie daher vor dem Produktivbetrieb mit einer eigenen Stichprobe.
Häufige Fragen
Werden gescannte SDB-PDFs unterstützt?
Die API nimmt PDF-Dateien an, auch eingescannte. Konfidenzwert und Warnungen zeigen, wenn die Qualität niedrig ist und das Dokument geprüft werden sollte.
Wie bekomme ich einen API-Schlüssel?
Über das Self-Serve-Formular auf der Startseite, oder sprechen Sie uns für Enterprise an.
Wo finde ich die technische Spezifikation?
Als OpenAPI-Vertrag, dazu API-Dokumentation und Clients (englisch).
Wo werden die Daten verarbeitet?
Informationen zu Datenresidenz und Aufbewahrung finden Sie unter Datenresidenz und Sicherheit (englisch).