Central de ajuda

平台接口如何对接（以 AliExpress 为例）

这篇教程解决什么问题

ERP 开放 API 里的「平台接口」，是把各电商平台的官方开放接口统一代理到 ERP：你不需要自己维护平台应用的 AppKey、AppSecret，也不需要自己处理签名和 Token 刷新，只要店铺已经在 ERP 完成授权，就可以通过 ERP 的固定地址调用平台接口。

本教程以 AliExpress（速卖通）为例，对应页面：系统 > 开放API管理 > API能力说明 > 平台接口 > AliExpress。

开始前先准备

  1. 已授权的 AliExpress 店铺：先在 ERP 的「系统 > 系统授权」完成速卖通店铺授权，并确认店铺状态正常。
  2. 可用的 AccessToken：在「AccessToken管理」中创建，平台接口调用会计入该 Token 所属账号的每日开放 API 配额。
  3. 店铺 sid：调用时用来指定用哪家已授权店铺的身份去请求平台。
  4. 确认会员等级：平台接口对会员等级有要求，页面会提示当前套餐是否可用；不可用时先按页面提示查看会员套餐。

第 1 步：进入「平台接口」

打开「系统 > 开放API管理」，切到「API能力说明」，在上方选择「平台接口」。左侧是当前支持代理的平台列表，右侧是所选平台的说明和调用方案。

第 2 步：选择 AliExpress，先看三块信息

  1. 平台官网接口：AliExpress Open Platform（https://open.aliexpress.com/）。接口名称、参数和返回结构以速卖通官方文档为准。
  2. ERP调用地址：/open-api/agent/aliexpress/invoke，前面拼上你的 ERP 访问域名。
  3. 请求示例：页面会给出当前平台的请求体结构，照着替换店铺 sid、平台接口名和参数即可。

第 3 步：理解请求体

AliExpress 平台接口使用 POST，请求体是四部分：

  • sid：已授权 AliExpress 店铺的店铺编号，用数字。
  • api：速卖通开放平台的接口名称，例如 aliexpress.seller.info.get。
  • method：该平台接口要求的请求方式，常见为 post 或 get。
  • params：平台接口的业务参数，按速卖通官方文档填写；AliExpress 这一路使用字符串键值对。

第 4 步：发起调用

请求头同样使用 AccessToken：

Content-Type: application/json
AccessToken: 你的真实Token
curl -X POST 'https://你的ERP域名/open-api/agent/aliexpress/invoke' \
  -H 'Content-Type: application/json' \
  -H 'AccessToken: 你的真实Token' \
  -d '{"sid":0,"api":"aliexpress.seller.info.get","method":"post","params":{}}'

把 sid 换成你自己的店铺编号；api 和 params 按这次要做的业务换成速卖通官方接口名和参数。第一次建议先调一个只读、参数简单的接口，确认链路通了再扩展。

第 5 步：服务端做了什么

  1. 校验 AccessToken 是否有效，以及 Token 所属账号是否还有当日调用配额。
  2. 校验传入的 sid 是否属于该账号，并确认店铺平台类型是 AliExpress。
  3. 取出该店铺在 ERP 里的授权信息，自动完成平台要求的签名。
  4. 把请求转发到速卖通开放平台，并把平台返回结果回传给你。
  5. 记录本次调用，计入调用统计。

所以你不必自己保存平台 AppSecret，也不要在请求里传平台 Token；这些都由 ERP 侧按已授权店铺处理。

第 6 步：返回结果与排查

返回统一是 JSON。先看 success：为 true 时业务数据在 data 中；为 false 时看 message。平台自身的业务错误通常会保留在返回内容里，需要结合速卖通官方文档判断。

  • 店铺不属于当前账号：sid 填错，或该店铺没有授权在当前 Token 所属账号下。
  • 店铺平台类型不符：sid 对应的不是 AliExpress 店铺，换正确的店铺编号。
  • 接口名或参数错误：对照速卖通开放平台文档检查 api 名称、method 和 params 字段。
  • 配额不足：平台接口调用计入 AccessToken 所属账号的每日开放 API 配额，等次日恢复或调整套餐。
  • Token 无效：检查请求头是否为 AccessToken，Token 是否完整、是否已停用。

安全与使用建议

  • AccessToken 放在服务端，不要下发到浏览器或公开仓库。
  • 按用途拆分 Token，平台接口和 ERP 内部能力可以分开管理。
  • 先用小参数、只读接口验证，再接入批量或写入类操作。
  • 平台接口的能力边界以速卖通官方文档为准，ERP 负责代理和签名，不改变平台接口本身的业务规则。

一句话记住

店铺先在 ERP 授权，再用 AccessToken 调 /open-api/agent/aliexpress/invoke；请求体记住四件事：sid、api、method、params，签名和平台 Token 交给 ERP。

Compartilhar artigo

Índice