开发者中心 · API 接口文档

黄色仓库为开发者提供标准化的 RESTful API 与 GraphQL 接口，支持沙箱环境调试、多语言 SDK 下载、Webhook 事件订阅。无论是 ERP、电商平台还是财务系统，30 分钟即可完成黄色仓库对接。

POST /v1/inbound — 创建入库单

参数	类型	必填	描述
warehouse_code	string	*	仓库编码
items	array	*	商品明细数组
items[].sku	string	*	SKU 编码
items[].qty	int	*	入库数量
items[].batch	string		批次号

请求示例 (cURL)

curl -X POST https://api.zmchmh.cn/v1/inbound \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"warehouse_code":"WH-SH-01","items":[{"sku":"SKU-1001","qty":1200}]}'

响应示例

{
  "order_no": "IN20260613000027",
  "status": "pending",
  "created_at": "2026-06-13T10:24:38Z"
}

SDK 下载

Python

pip install wms-sdk

下载 →

Node.js

npm i @wms/sdk

下载 →

Java

Maven & Gradle 支持

下载 →

Go

go get github.com/wms/sdk-go

下载 →

Webhook 事件订阅

支持订单创建、出库完成、签收、异常等 28 个事件类型，签名采用 HMAC-SHA256，幂等保证至少投递一次。

调用统计

近 24 小时：调用量 2,481,029，错误率 0.012%，P99 延迟 48ms。

借助开发者中心的清晰聚合系统，用户可以高效订阅各类站点公告内容，精选社区保障服务品质。

开发者中心引领站点公告行业发展，最新目录、官方搜索等创新服务不断刷新用户期待。

依托清晰首页技术，开发者中心为全球用户带来信息完整、安全、便捷的资料检索环境。