新品上线 AI 落地 - 免费出 AI 落地报告,找出你的企业最值得先做的三个 AI 应用 立即体验
新品上线 斟酌——让 Word 文档 AI 处理,依然可控。 前 100 名用户享特殊权益。 立即体验
接入前准备:请先向智化科技申请 API 密钥。密钥应仅保存在服务端,切勿写入浏览器代码、公开仓库或客户端应用。

文档概览

SDS API 由杭州智化科技有限公司(XiXisys)提供。每次调用使用 CAS 号定位物质,可选择 GHS 版或中文版 SDS;未传 edition 时默认返回 ghs 版本。

可用接口
  • HTML SDS:用于网页内直接展示。
  • PDF SDS:用于下载或在线预览。
  • DOCX SDS:用于获取可编辑的 Word 文档。

认证方法

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 号。
editionghsSDS 版本类型:ghscn

SDS 文档 - HTML

需要在网站页面中直接展示 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"

SDS 文档 - PDF

需要下载或预览 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"

SDS 文档 - DOCX

需要可编辑的 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 号和版本参数是否正确。如仍无法解决,请联系智化科技技术支持。建议在您的服务端安全记录必要的调用上下文并做好失败处理,避免对失败请求无限重试。

咨询接入方案 返回 SDS API 介绍