开放 API 与 AccessToken 管理指南

开始前确认

• 页面登录即可访问，但 平台接口 分区要求 VIP5 及以上会员，达不到等级时该分区会提示 平台接口仅 VIP5 及以上会员可用，详情请查看。
• 若当前会员等级完全无法使用本功能，页面顶部会提示 当前会员等级无法使用此功能，详情请查看，可点击 会员套餐 了解升级方式。
• AccessToken 数量与每日调用次数都受会员额度限制，达到上限后 创建AccessToken 按钮不可点击并提示 AccessToken 数量已达到上限。

创建 AccessToken

1. 打开 AccessToken管理 页签，右上角会显示 今日API调用 的当前用量。
2. 点击 创建AccessToken 打开弹窗，在 名称 中填写用途，例如按调用方或环境命名。
3. 在 权限范围 中勾选本 Token 允许访问的接口范围，默认已选 全部开放API；建议按最小可用原则只勾选需要的项。
4. 点击 保存，成功后弹窗会提示 AccessToken 仅本次展示，请立即复制保存，此时点击 复制 并妥善留存。

管理已有 AccessToken

AccessToken管理 列表展示 名称、AccessToken、状态、启用、今日调用 与 操作 六列。

列表上方还有 刷新 按钮，可重新拉取列表与今日调用量。

查阅 API 能力说明

API能力说明 页签左侧为 能力分类，包含 概览 与 基础；右侧可按 API、平台接口、数据格式 三个分区切换。

1. API 分区以表格列出 开放API路径、名称、说明、模块、文档地址，点击 查看 打开该接口的文档。
2. 概览 分区给出 基础调用示例，并提示「调用开放 API 时，请将 AccessToken 替换为在 AccessToken管理 中创建的真实 Token。」
3. 数据格式 分区列出各枚举值与字段结构，字段表包含 字段、类型、必填、说明。
4. 需要把接口清单交给 AI 智能体时，点击 复制 Skill Manifest 地址。

核对调用统计

1. 打开 调用统计 页签，顶部卡片显示 总调用、成功调用、失败调用、成功率。
2. 用日期选择器限定统计日期，表格按 API、方法、调用次数、成功、失败、日期 逐行展示明细。
3. 发现失败次数偏高时，回到 AccessToken管理 检查对应 Token 是否被禁用、权限范围是否覆盖该接口。

按场景查找分组接口

如果要在开放 API 中按“公共分组 / 专属分组 / 待发布”筛选产品，按以下顺序查找和调用：

1. 在“API能力说明”左侧选择 产品刊登 → 产品管理 → 分组与筛选。
2. 调用 获取业务分组（/open-api/group/get_groups）获取公共分组和专属分组的 ID 与名称，project 传 product。
3. 调用 获取产品分组统计（/open-api/product/get_group_count）获取分组数量和 statusCount.unpublish（待发布）。速卖通 project 传 AliExpressProductGroup。
4. 调用 查询产品列表（/open-api/product/get_list），在 filters 中传 public_gid、private_gid 或 publishStatus: "unpublish"。