通过一个安全、标准的接口,把合规 SDS 文档接入您的网站、电商平台或内部系统。HTML 用于网页直接展示,PDF 与 DOCX 用于下载、预览和后续业务流程。
SDS API 由杭州智化科技有限公司(XiXisys)提供。每次调用使用 CAS 号定位物质,可选择 GHS 版或中文版 SDS;未传 edition 时默认返回 ghs 版本。
API 使用密钥认证每一次请求。请在请求标头(Headers)中传入 X-Api-Key,并将申请到的密钥作为其值。
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/html?cas=50-00-0"
| 参数 | 默认值 | 说明 | 是否必填 |
|---|---|---|---|
cas | 无 | 物质的 CAS 号。 | 是 |
edition | ghs | SDS 版本类型:ghs 或 cn。 | 否 |
需要在网站页面中直接展示 SDS 时,调用此接口。
| 方法 | GET |
|---|---|
| 地址 | https://sds-api.xixisys.com/v1/sds/html |
# 获取 CAS 50-00-0 的 GHS 版 HTML SDS
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/html?cas=50-00-0"
# 获取 CAS 50-00-0 的中文版 HTML SDS
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/html?cas=50-00-0&edition=cn"
需要下载或预览 PDF SDS 时,调用此接口。
| 方法 | GET |
|---|---|
| 地址 | https://sds-api.xixisys.com/v1/sds/pdf |
请求成功时返回 data 字段,其中为可下载链接地址;请求失败时返回 error 字段。
# 获取 CAS 50-00-0 的 GHS 版 PDF SDS
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/pdf?cas=50-00-0"
# 获取 CAS 50-00-0 的中文版 PDF SDS
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/pdf?cas=50-00-0&edition=cn"
需要可编辑的 Word SDS 文档时,调用此接口。
| 方法 | GET |
|---|---|
| 地址 | https://sds-api.xixisys.com/v1/sds/docx |
请求成功时返回 data 字段,其中为可下载链接地址;请求失败时返回 error 字段。
# 获取 CAS 50-00-0 的 GHS 版 DOCX SDS
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/docx?cas=50-00-0"
# 获取 CAS 50-00-0 的中文版 DOCX SDS
curl -H "X-Api-Key: YOUR_API_KEY" "https://sds-api.xixisys.com/v1/sds/docx?cas=50-00-0&edition=cn"
调用失败时,请先查看响应中的 error 信息,并核对 API 密钥、CAS 号和版本参数是否正确。如仍无法解决,请联系智化科技技术支持。建议在您的服务端安全记录必要的调用上下文并做好失败处理,避免对失败请求无限重试。