店小秘开发者计划：开放API与Webhook

2026 年 6 月 2 日，店小秘发布开发者计划。开放平台提供订单、库存、商品与物流四组 API，并支持 Webhook 事件订阅。开发者可以在沙箱环境调试，正式环境按套餐分配调用配额。

中大型卖家通常有自建 ERP、BI 或财务系统，需要与店小秘交换数据。过去依赖表格导入导出，时效差且容易出错。开放平台把这些能力标准化，减少重复开发。

接口范围与鉴权方式

首批开放 38 个接口，覆盖订单查询与状态回写、库存同步、商品资料读取、物流单号回传。接口采用 OAuth 2.0 客户端凭证鉴权，密钥按应用隔离，支持按 IP 白名单限制来源。

Webhook 支持订单创建、付款、发货、退款与库存变更五类事件。订阅方需要提供回调地址与签名密钥，系统在失败后按指数退避重试，最多 8 次，并在控制台展示投递记录。

“开放接口的价值是让数据流动起来，同时把权限边界说清楚。”—— 沈一帆，店小秘平台产品负责人

沙箱与配额

沙箱环境提供模拟店铺与测试订单，开发者可以在不影响生产数据的情况下联调。正式环境按套餐分配每日调用额度，基础版 1 万次，专业版 20 万次，企业版可申请提升。超限请求返回明确错误码，不静默丢弃。

平台提供 Python、Node.js 与 PHP 的示例代码，以及 Postman 集合。首批接入的 27 家服务商平均用 6 天完成首个场景联调，比过去的表格方案减少约两周。

“沙箱加示例代码，我们六天就跑通了订单回写。”—— 杜衡，电商服务商技术负责人

安全与治理

所有接口调用记录请求方、应用与时间，敏感字段脱敏展示。开发者需要声明数据用途，平台按最小权限原则审核。出现异常调用时，系统可以自动冻结应用并通知负责人。

后续将开放采购与财务接口，并增加事件回放能力。团队也在建设服务商目录，帮助卖家找到经过验证的集成方案。

开发者计划已开放申请，专业版与企业版可直接创建应用。建议先在沙箱验证签名与重试逻辑，再切换正式环境。接口文档可在开放平台查看。