Xcotton 开发者文档
选择适合你的接入方案。优先使用适用的平台方案；同一业务职责不得由平台方案和自研 OpenAPI 重复实现。 细节见 选择接入方式。
选择适合你的接入方案
Section titled “选择适合你的接入方案”Shopify Headless SDK
使用 Xcotton SDK 与 Widget；SDK 通过 Shopify Storefront API 操作购物车，商家通常无需直接接入 Xcotton OpenAPI。
OpenAPI 自主接入
自行开发前端，由商家服务端接入 Xcotton OpenAPI 与 Webhooks。
两个入口都先进入「选择接入方式」，再进入具体方案。
- 开始使用 — 选择接入方式
- Shopify Headless SDK 接入 — 接入前指引 · 快速开始 · SDK 参考
- OpenAPI 自主接入 — 接入准备 · 业务流程 · 商品与报价 · 订单与履约 · 理赔
- OpenAPI 参考 — 交互式 API 参考
指南页面说明接口的调用时机、必填条件、常见错误与 JSON 示例。字段名称、类型与描述以 API 参考为准。Webhook 由 Xcotton 向你们配置的 URL 推送，参考页仅展示报文格式，请勿向 OpenAPI 域名发送测试请求。
环境（OpenAPI 自主接入）
Section titled “环境（OpenAPI 自主接入）”下列地址是 OpenAPI 出站环境，不是 Shopify Headless SDK 的必要配置。完整说明见 认证、签名与通用规则。
| 环境 | 地址 |
|---|---|
| 测试 (beta) | https://betaxcottons.xmhhulu.com |
| 生产 (美国) | https://openapi.xcottons.com |