DACH

Sicherheitsdatenblätter (SDB) in JSON umwandeln

Q: Kann ich XML oder CSV statt JSON bekommen?

Ja. Alle drei Formate stehen in derselben Antwort unter outputs.

Welcher SDB-Abschnitt in welchem JSON-Schlüssel landet, und wie Sie mit curl und jq an die Werte kommen.

Letzte Aktualisierung: 2026-10-24

Von der PDF zur Antwortdatei

curl -X POST "https://safetydatasheetapi.com/extract-sds" \
  -H "Authorization: Bearer $SDS_API_KEY" \
  -F "[email protected]" \
  -F "language_hint=de" \
  -o antwort.json

Die Antwort enthält unter outputs.json einen Schlüssel je SDB-Abschnitt, dazu outputs.xml, outputs.csv, confidence_score und warnings.

Feldzuordnung: SDB-Abschnitt zu JSON-Schlüssel

SDB-Abschnitt	Schlüssel in outputs.json
1. Bezeichnung des Stoffs bzw. des Gemischs und des Unternehmens	`product_identification`
2. Mögliche Gefahren	`hazards_identification`
3. Zusammensetzung/Angaben zu Bestandteilen	`composition`
4. Erste-Hilfe-Maßnahmen	`first_aid`
5. Maßnahmen zur Brandbekämpfung	`fire_fighting`
6. Maßnahmen bei unbeabsichtigter Freisetzung	`accidental_release`
7. Handhabung und Lagerung	`handling_storage`
8. Begrenzung und Überwachung der Exposition/Persönliche Schutzausrüstungen	`exposure_controls_ppe`
9. Physikalische und chemische Eigenschaften	`physical_chemical_properties`
10. Stabilität und Reaktivität	`stability_reactivity`
11. Toxikologische Angaben	`toxicological_information`
12. Umweltbezogene Angaben	`ecological_information`
13. Hinweise zur Entsorgung	`disposal_considerations`
14. Angaben zum Transport	`transport_information`
15. Rechtsvorschriften	`regulatory_information`
16. Sonstige Angaben	`revision_metadata`

Garantiert sind die 16 Abschnittsschlüssel. Die Felder innerhalb eines Abschnitts richten sich nach dem Dokument; die Namen unten stammen aus einer Beispielantwort, bilden Sie sie daher defensiv ab.

Werte mit jq herausziehen

Mit jq lesen Sie die gespeicherte Antwortdatei auf der Kommandozeile:

# UN-Nummer
jq -r '.outputs.json.transport_information.un_number' antwort.json

# Bestandteile als CSV: Name und CAS-Nummer
jq -r '.outputs.json.composition[] | [.substance_name, .cas_number] | @csv' antwort.json

# Konfidenz und Warnungen
jq '{konfidenz: .confidence_score, warnungen: .warnings}' antwort.json

JSON, XML oder CSV?

Format	Geeignet für	Zu beachten
JSON	Neue Integrationen; unterscheidet `null` von leer.	Innere Feldnamen richten sich nach dem Dokument.
XML	Systeme, die XML erwarten.	Listen mit einem Eintrag sehen aus wie Einzelwerte, leere Elemente sind mehrdeutig. Details: SDS to XML (englisch).
CSV	Flache Liste `field,value` für Tabellenkalkulationen.	Werte, die mit `=`, `+`, `-` oder `@` beginnen, erhalten ein vorangestelltes Apostroph; aus `-20` wird `'-20`.

Mehrsprachige Dokumente

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.

So kommen Sie zum Zugang: Der kostenlose Beispiel-Upload auf der Startseite braucht keinen Schlüssel, im Self-Serve-Tarif erhalten Sie nach der Anmeldung einen eigenen API-Schlüssel, und Enterprise-Kunden erhalten ein dediziertes Deployment mit eigener Basis-URL. Siehe Preise.

Häufige Fragen

Sind die Schlüssel auf Deutsch?

Nein. Die Feldnamen sind immer dieselben englischen Schlüssel, sodass Ihre Integration unabhängig von der Dokumentsprache gleich funktioniert.

Kann ich XML oder CSV statt JSON bekommen?

Ja. Alle drei Formate stehen in derselben Antwort unter outputs.

Gibt es fertige Clients?

Ja, für Python und JavaScript sowie eine Postman-Sammlung. Siehe Clients und Codebeispiele (englisch).

Sicherheitsdatenblätter (SDB) in JSON umwandeln

Von der PDF zur Antwortdatei

Feldzuordnung: SDB-Abschnitt zu JSON-Schlüssel

Werte mit jq herausziehen

JSON, XML oder CSV?

Mehrsprachige Dokumente

Häufige Fragen

Verwandte Seiten