分销与 API:从申请到第一次接口联调
了解申请入口、审核进度与凭证管理,按顺序完成接口接入。
01 · 提交申请并查看进度
登录后进入「分销合作」,按照页面要求填写站点及业务信息并提交。审核中的申请可在同一页面查看进度;如被驳回,根据页面展示的原因修正资料后再提交。
分销商身份与 API 权限是不同的能力,请分别查看对应状态。需要通过接口采购时,进入「我的账户 → API 对接」申请接口权限,审核通过后再进行联调。
02 · 保存接口凭证
在 API 对接页面查看接口地址、凭证状态和示例。凭证只应放在你自己的服务端环境变量中,不要写进前台页面、公开仓库或客服聊天截图。密钥重置后,使用旧密钥的服务需要同步更新。
03 · 先测试读取,再测试下单
先使用页面提供的示例请求只读接口,核对签名、时间戳和返回结构。商品上架前建立商品与规格映射,确认价格、币种和库存含义。创建订单前,应先约定超时查询、重复请求及回调验签的处理方式。
04 · 处理异常与重复通知
网络超时不能证明订单创建失败,应先用原始业务订单标识查询状态。回调处理需要验签并保持幂等,避免重复交付。日志应记录订单标识和错误码,隐藏密钥与交付内容。
查看分销申请 · 打开 API 对接