除了内部技术分享，海鸥技术部落还维护着一套面向商户和 ERP 服务商的开放 API。这篇是能力概览和集成路径，帮你判断「要不要接、从哪里接」；具体接口的参数、字段和示例一律以官方文档为准，见 docs.kakaclo.com。

它解决什么问题

KAKACLO 是跨境服装供应链平台，开放 API 的定位是让第三方系统（自建 ERP、店铺管理工具、独立站后台）能够直接读写商品、库存、订单和 POD 定制数据，而不是让运营在两个后台之间手工搬运。典型的接入方是已经有自己订单系统、需要把 KAKACLO 作为供货与履约后端的商家。

能力分成四块

1. 商品（Product）

• Category：类目树，用于把平台类目映射到你自己的类目体系
• Products：商品与 SKU 详情
• Stock：库存查询
• CountryAndWarehouse：国家与仓库的对应关系——这是跨境场景里最容易被忽略却最关键的一张表，它决定了同一个 SKU 能从哪个仓发往哪个国家
• Product API pull suggestion：官方给出的商品拉取策略建议，全量同步之前值得先读这页

2. 订单（Order）

订单 API 有 V1 和 V2 两个版本，V1 在文档中已标记为 Outdated，新接入直接用 V2。覆盖下单、订单查询、订单状态、退款单创建与查询，V2 另外提供了自动分物流渠道（Automatic Split Logistics Channel）。

有一条行为需要在设计自己的订单模型时就考虑进去：创建订单时，系统会按 SKU 所在仓库的位置自动拆单，一次请求可能生成多个订单。如果你的系统假设「一个本地订单对应一个平台订单」，接入时就会对不上账。

3. POD 定制（Custom Product）

这块是给做定制服装的商家用的：获取可设计的款式类目与模型、读取设计器里已完成的设计、保存设计稿、用设计好的产品直接下单。通过这组接口创建的定制商品，会出现在 KAKACLO 后台的定制商品列表里，和在网页设计器上手工做的是同一份数据。

4. 资金（Payment）

目前是余额查询。批量下单前先查余额，是避免整批订单因余额不足而失败的常规做法。

接入要点

鉴权

用 Access-Token，放在请求头里：Authorization: Bearer YOUR_ACCESS_TOKEN。Token 由对接的业务经理发放，不是自助注册拿到的——也就是说走通商务流程是技术接入的前置条件。

环境

• 生产：https://developer.kakaclo.com/openapi
• 测试：https://test-developer.kakaclo.com/openapi

全部只走 HTTPS。有独立测试环境这点值得用起来，订单类接口在生产上试错的代价不低。

限流

REST Admin API 用漏桶（leaky bucket）限流，默认桶容量 120 个请求、漏出速率 2 次/秒，超出返回 429 Too Many Requests。

漏桶的意思是：你可以短时间突发打满 120 个请求，但长期平均速率不能超过 2 次/秒。所以全量同步商品这类任务，正确做法是控制在 2 QPS 附近匀速跑，而不是并发轰完再等封禁解除。限流按「应用 + 店铺」组合计算，不同应用之间互不影响。

版本与变更

文档站有独立的 Release Notes，记录从 2022-12 至今的接口变更，包括订单 V2 的发布、订单自动拆单的接口调整、CountryAndWarehouse 的字段变化、商品接口增加 supplierLevel、以及 Token 刷新能力的加入。接入前把 Release Notes 从新到旧扫一遍，比逐个接口读文档更快能判断出哪些字段是近期才有的、哪些用法已经过时。

从哪开始

1. 找业务经理拿测试环境的 Access-Token
2. 先跑通 Category 和 CountryAndWarehouse，把类目与仓库映射建起来
3. 再接 Products / Stock，按官方的 pull suggestion 做首次全量 + 增量同步
4. 最后接订单 V2，重点处理自动拆单带来的一对多关系

完整接口文档：docs.kakaclo.com