1. 官方接口与功能范围
工作台通过 Amazon Selling Partner API（SP-API）对接商品管理，主要涉及以下三组接口：
| 接口 | 用途 |
|---|---|
| Listings Items API | 单个 SKU 的创建、更新、暂停、删除、查询 |
| Feeds API | 批量任务：一次提交多个 SKU 的上下架或改价，异步返回处理报告 |
| Product Type Definitions API | 取类目的合法属性与选项，避免提交无效字段 |
2. 授权流程与当前状态
授权在 Amazon 官方页面完成。内测阶段由技术支持协助配置；以下为正式自助授权开放后的流程说明：
- 在 授权页点击「连接 Amazon 店铺」，跳转到 Amazon 官方登录与授权页面；
- 你在 Amazon 侧确认授权后，Amazon 把授权码回传给我们；
- 工作台通过受信任的授权流程，以一次性授权码换取刷新令牌和短期访问令牌，再根据 Amazon 当前的接口认证要求发起请求。
- 你可在软件内删除店铺以清除本机凭据；如需撤销平台侧授权，还应在 Amazon 卖家后台移除应用。两项操作分别负责本地清理与平台授权撤销。
当前采用协助配置的内测方式。公网自助授权与后续令牌管理方案尚未正式开放；如未来数据处理方式发生变化，将同步更新本页与隐私政策。
3. 权限范围与最小权限原则
| 角色 | 用途 |
|---|---|
| Product Listing | 创建与更新 Listing、上下架、读取类目属性定义 |
| Pricing | 读取与更新售价 |
| Inventory | 读取与更新可售库存 |
| Orders / 买家 PII | 不申请。本产品不接触买家姓名、电话、地址、邮箱 |
| Advertising | 不申请。广告方案在本地生成，不读取广告后台数据 |
我们遵循最小权限原则：没有对应功能的版本不申请对应角色；授权页会明确列出当前申请的每一项权限。
4. 数据用途、存储与保留期限
| 数据 | 用途 | 存储位置 | 保留期 |
|---|---|---|---|
| 店铺标识、授权令牌 | 调用接口；刷新访问令牌 | 你本机的加密配置目录 | 删除店铺时清除本机凭据；在平台侧另行撤销授权 |
| SKU、ASIN、Listing 属性 | 生成上架内容、对账 | 你本机的任务数据目录 | 你删除任务或清空历史时删除 |
| 上下架结果与错误报告 | 显示执行结果、重试失败项 | 你本机的任务数据目录 | 同上 |
| 访问日志 | 排查问题、安全审计 | 你本机 | 按所用版本的日志设置保留，可由用户自行清理 |
上述数据默认存放在本机，不用于我们的模型训练、转售或广告画像。完成平台操作所需数据会发送至 Amazon；用户主动调用模型时，相应任务内容会发送至其配置的模型服务商。具体范围见隐私政策。
5. 撤销授权与删除数据
- 软件内清理：在“Amazon 集成”中选择店铺并删除，清除本机令牌与缓存。此操作不等同于平台侧撤销授权。
- Amazon 侧撤销：在卖家后台“应用与服务 → 管理你的应用”移除授权；撤销结果与生效时间以平台反馈为准。
- 申请删除：联系渠道公布后，可提交我们持有的联系与支持记录的删除请求，核实后按适用法律处理；本机数据仍需由你自行清理。
6. 安全措施
- 与 Amazon 的通信使用 HTTPS/TLS，接口认证遵循 Amazon 当前 SP-API 要求；凭据不以明文写入日志。
- 本机凭据按产品设计加密保存，结合操作系统权限限制访问。具体措施见交付版本的安全说明。
- 令牌按最小范围申请，不跨店铺复用；接口调用有频次限制与退避重试。
- 商品写入操作须经用户明确发起和确认；内测阶段按开通方式提供操作入口或现场协助，执行结果可查询。
更完整的安全说明见 数据安全。
7. 当前可用状态
上下架能力已完成接口层开发与内部联调，目前处于内测阶段，面向少量客户开放，需要由我们协助配置店铺与权限。正式开放后会在本页与功能页同步更新。在此之前，官网不把它描述为已全面上线的功能。
8. 官方资料
本页所述接口名称与能力范围以 Amazon 官方文档为准；接口如有变更，我们会同步调整实现并在本页更新。