SDS Integration API Documentation

Before you begin: request an API key from XiXisys. Keep it server-side and do not expose it in browser code, public repositories or client-side applications.

Overview

The SDS API is provided by Hangzhou Zhihua Technology Co., Ltd. (XiXisys). Each request identifies a substance by CAS number and can select the GHS edition or Chinese edition. The default edition is ghs.

Available resources

HTML SDS — display an SDS in a web page.
PDF SDS — receive a downloadable document URL.
DOCX SDS — receive a downloadable editable document URL.

Authentication

Every request is authenticated with your API key. Send it in the X-Api-Key request header.

curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/html?cas=50-00-0"

Common request parameters

Parameter	Default	Description	Required
`cas`	—	CAS Registry Number of the substance.	Yes
`edition`	`ghs`	SDS edition: `ghs` or `cn`.	No

SDS document — HTML

Use this endpoint when your application needs an HTML SDS for web presentation.

Method	`GET`
Endpoint	`https://sds-api.xixisys.com/v1/sds/html`

# GHS SDS in HTML for CAS 50-00-0
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/html?cas=50-00-0"

# Chinese SDS in HTML for CAS 50-00-0
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/html?cas=50-00-0&edition=cn"

SDS document — PDF

Use this endpoint when your workflow requires a PDF document for download or preview.

Method	`GET`
Endpoint	`https://sds-api.xixisys.com/v1/sds/pdf`

On success, the response contains a downloadable URL in data. On failure, the response contains an error message.

# GHS PDF for CAS 50-00-0
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/pdf?cas=50-00-0"

# Chinese PDF for CAS 50-00-0
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/pdf?cas=50-00-0&edition=cn"

SDS document — DOCX

Use this endpoint when you need an editable Word document for an internal workflow.

Method	`GET`
Endpoint	`https://sds-api.xixisys.com/v1/sds/docx`

On success, the response contains a downloadable URL in data. On failure, the response contains an error message.

# GHS DOCX for CAS 50-00-0
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/docx?cas=50-00-0"

# Chinese DOCX for CAS 50-00-0
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/docx?cas=50-00-0&edition=cn"

Errors and support

If a request cannot be completed, read the returned error message, confirm that the API key, CAS number and edition are valid, then contact XiXisys for technical assistance. Do not retry a failed request indefinitely; log the request context safely and handle failures in your application.