平台接口如何对接（以 AliExpress 为例）
关键词 平台接口 AliExpress 速卖通 开放API API对接
本教程适用于「系统 → 开放API管理 → API能力说明 → 平台接口」页面，以 AliExpress（速卖通）为例，说明如何通过 ERP 代理调用平台官方接口。不包含平台侧应用申请、店铺入驻和资质审核流程。
开始前确认
- 已授权的 AliExpress 店铺：先在 ERP 的「系统 → 系统授权」完成速卖通店铺授权，并确认店铺状态正常。
- 可用的 AccessToken：在「AccessToken管理」中创建，平台接口调用会计入该 Token 所属账号的每日开放 API 配额。
- 店铺 sid：调用时用来指定用哪家已授权店铺的身份去请求平台。
- 已确认会员等级满足平台接口要求；页面提示不可用时，先按提示查看会员套餐。
进入「平台接口」
打开「系统 → 开放API管理」，切到「API能力说明」，在上方选择「平台接口」。左侧是当前支持代理的平台列表，右侧是所选平台的说明和调用方案。
【推荐截图：API能力说明 → 平台接口 → AliExpress，含 ERP调用地址与请求示例】
核对 AliExpress 的三块信息
- 平台官网接口：AliExpress Open Platform（https://open.aliexpress.com/）。接口名称、参数和返回结构以速卖通官方文档为准。
- ERP调用地址：
/open-api/agent/aliexpress/invoke，前面拼上你的 ERP 访问域名。 - 请求示例：页面会给出当前平台的请求体结构，照着替换店铺 sid、平台接口名和参数即可。
理解请求体
AliExpress 平台接口使用 POST，请求体由四部分组成：
| 字段 | 含义 | 示例 |
|---|---|---|
sid | 已授权 AliExpress 店铺的店铺编号，用数字。 | 0（替换为你的店铺编号） |
api | 速卖通开放平台的接口名称。 | aliexpress.seller.info.get |
method | 该平台接口要求的请求方式，常见为 post 或 get。 | post |
params | 平台接口的业务参数，按速卖通官方文档填写；AliExpress 这一路使用字符串键值对。 | {} |
发起调用
请求头同样使用 AccessToken：
| 请求头 | 值 | 说明 |
|---|---|---|
Content-Type | application/json | 固定使用 JSON 请求体。 |
AccessToken | 你的真实Token | 在「AccessToken管理」中创建，平台接口调用计入该账号配额。 |
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 按这次要做的业务换成速卖通官方接口名和参数。
了解服务端处理流程
- 校验 AccessToken 是否有效，以及 Token 所属账号是否还有当日调用配额。
- 校验传入的 sid 是否属于该账号，并确认店铺平台类型是 AliExpress。
- 取出该店铺在 ERP 里的授权信息，自动完成平台要求的签名。
- 把请求转发到速卖通开放平台，并把平台返回结果回传给你。
- 记录本次调用，计入调用统计。
返回结果与排查
返回统一是 JSON。先看 success：为 true 时业务数据在 data 中；为 false 时看 message。平台自身的业务错误通常会保留在返回内容里，需要结合速卖通官方文档判断。
| 返回情况 | 常见原因 | 处理方式 |
|---|---|---|
| 店铺不属于当前账号 | sid 填错，或该店铺没有授权在当前 Token 所属账号下。 | 核对店铺编号，确认授权账号与 Token 所属账号一致。 |
| 店铺平台类型不符 | sid 对应的不是 AliExpress 店铺。 | 换正确的店铺编号后重试。 |
| 接口名或参数错误 | api 名称、method 或 params 字段与平台文档不一致。 | 对照速卖通开放平台文档逐项检查。 |
| 配额不足 | 平台接口调用计入 AccessToken 所属账号的每日开放 API 配额。 | 等次日恢复或调整套餐。 |
| Token 无效 | 请求头名称错误，或 Token 不完整、已停用。 | 检查请求头是否为 AccessToken，重新复制或创建 Token。 |
完成检查
- AliExpress 店铺已在 ERP 完成授权，店铺状态正常。
- AccessToken 有效，且所属账号还有当日平台接口调用配额。
- 请求体中的 sid、api、method、params 与店铺和速卖通官方文档一致。
- 调用返回
success:true，平台业务数据能从data中读取。