Pohjoismaat

Muunna käyttöturvallisuustiedote (KTT) JSON-muotoon

Lähetä käyttöturvallisuustiedote PDF:nä ja saat jäsennellyn JSON-objektin, jossa on yksi kenttä per kohta, sekä XML:n ja CSV:n.

Päivitetty viimeksi: 2026-10-24

Näin se toimii

Lähetä PDF muodossa multipart/form-data osoitteeseen POST /extract-sds API-avaimellasi.
Saat JSON-vastauksen, jossa on outputs.json, outputs.xml ja outputs.csv sekä confidence_score ja warnings.
Kuvaa kentät omaan skeemaasi. Kenttien nimet ovat samat kaikille asiakirjoille.

Kenttäkartta: käyttöturvallisuustiedotteen kohdat JSON-avaimiin

Kohta	Avain tiedostossa outputs.json
1. Aineen/seoksen ja yhtiön/yrityksen tunnistustiedot	`product_identification`
2. Vaaran yksilöinti	`hazards_identification`
3. Koostumus/tiedot aineosista	`composition`
4. Ensiaputoimenpiteet	`first_aid`
5. Palontorjuntatoimenpiteet	`fire_fighting`
6. Toimenpiteet onnettomuuspäästöissä	`accidental_release`
7. Käsittely ja varastointi	`handling_storage`
8. Altistumisen torjunta/henkilönsuojaimet	`exposure_controls_ppe`
9. Fysikaaliset ja kemialliset ominaisuudet	`physical_chemical_properties`
10. Stabiilisuus ja reaktiivisuus	`stability_reactivity`
11. Myrkyllisyystiedot	`toxicological_information`
12. Ekologiset tiedot	`ecological_information`
13. Jätteiden käsittely	`disposal_considerations`
14. Kuljetustiedot	`transport_information`
15. Lainsäädäntöä koskevat tiedot	`regulatory_information`
16. Muut tiedot	`revision_metadata`

Monikieliset asiakirjat

API lukee PDF-muotoiset käyttöturvallisuustiedotteet sillä kielellä, jolla asiakirja on kirjoitettu. Voit antaa kielikoodin kentässä language_hint (esimerkiksi fi). Vastauksen kenttien nimet ovat aina samat englanninkieliset avaimet, ja H- ja P-lausekkeet, CAS-numerot ja UN-numerot ovat kieliriippumattomia. Tarkista vapaatekstikentät alkuperäisestä asiakirjasta: luottamusarvo ja varoitukset kertovat, milloin tarkistus on tarpeen. Emme vielä julkaise tarkkuutta kielikohtaisesti, joten validoi oman asiakirjaotoksen avulla ennen tuotantokäyttöä.

Esimerkki

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

{
  "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 ..."
  }
}

Vinkkejä integraatioon

Tallenna request_id tuloksen mukana.
Ohjaa varoituksia sisältävät tai matalan confidence_score-arvon asiakirjat tarkistukseen.
Kun saat vastauksen 429: odota Retry-After-otsakkeessa annettu määrä sekunteja.
Paljon tiedostoja? Lähetä enintään 10 yhtenä joukkoajona Idempotency-Key-otsakkeen kanssa, katso bulk ja webhookit.

Usein kysytyt kysymykset

Ovatko avaimet suomeksi?

Eivät. Kenttien nimet ovat aina samat englanninkieliset avaimet, joten integraatiosi toimii samalla tavalla asiakirjan kielestä riippumatta.

Voinko saada XML:n tai CSV:n?

Kyllä. Kaikki kolme muotoa ovat samassa vastauksessa kohdassa outputs.

Onko valmiita kirjastoja?

Kyllä, Pythonille ja JavaScriptille sekä Postman-kokoelma. Katso kirjastot ja koodiesimerkit.

Aiheeseen liittyvät sivut

Kokeile omalla asiakirjallasi: kokeile esimerkki-KTT:tä.

Muut kielet: English · Deutsch · Svenska · Norsk · Dansk