PPCWISER 琼仁智度 LogoPPCWISER琼仁智度
接入教程 · SP-API · 2026 版

SP-API 申请教程（2026）：从注册到拿到 Refresh Token 的完整流程

网上很多 SP-API 教程还停留在「卖家中心注册 + 建 AWS IAM 用户 + 签名」的旧流程。2026 年的流程是：Solution Provider Portal 注册与身份验证 → 私有开发者资料 → 草稿应用自授权 → 定期轮换 Secret。这一系列按现行官方文档逐栏写清。

免费试用 30 天从第 1 步开始
30 天免费试用¥99/月/店铺起凭证只存你自己的电脑
先弄清楚

SP-API 是什么？琼仁智度用它读哪些数据？

SP-API 是亚马逊给卖家与服务商的经营数据接口，按「角色」授权：申请了哪个角色，才能调用对应的接口和报告 [7]。广告数据不走 SP-API，而是 Amazon Ads API，两者需要分别申请 [8]。

PPCWISER 琼仁智度用 SP-API 读取以下数据，全部可以用非受限角色获得：

  • 订单报告（订单金额、SKU、ASIN，不含买家个人信息）
  • Finances 财务事件（退款）
  • FBA 库存与退货报告
  • 业务报告 Sales and Traffic（会话与转化）
  • Listings Items（读取与修改价格、促销价）
  • Product Fees（费用预估）、Catalog Items（商品目录）
  • Product Pricing（推荐报价 Featured Offer 相关价格）、A+ Content

没有受限角色时，美国站订单不会返回买家姓名、地址、电话、邮箱等个人信息，订单金额、SKU、ASIN 等不受影响 [9]。琼仁智度不获取买家个人信息，也不申请受限角色。每个数据对应哪个角色，见 开发者资料填写。

全流程

SP-API 申请 5 步一览

步骤在哪操作要做什么官方耗时 / 关键注意
① 准备资格与材料线下 + 卖家中心确认专业销售计划与主账号；备齐公司注册信息、证件、180 天内地址证明个人销售计划不能做私有卖家应用 [10]
② 注册与身份验证Solution Provider PortalRegister → Program Enrollment → Solution Type → Verify your identity审核最多 2 个工作日；提交后不可修改，结果为最终决定 [2]
③ 填写开发者资料SPP → Settings → Developer Profile选 Private Developer；勾非受限角色；如实写用例；答安全问卷标准角色通常 1–2 周；追问须 5 天内回复 [6][11]
④ 建应用与自授权SPP → Develop Apps创建 Production 草稿应用；查看 LWA 凭证；Authorize app 生成 Refresh Token私有应用草稿状态即可自授权；最多 10 个自授权 [12][13]
⑤ 轮换、撤销与排错SPP → Develop Apps → LWA credentials每 180 天轮换 Client Secret 并更新到中转客户端只有主账号能轮换；旧 Secret 7 天后失效 [4]
2026 年的变化

和网上旧教程相比，现在有哪些不一样？

  • 入口变了：开发者注册全面迁到 Solution Provider Portal，SPP 是全球账户，界面显示账户位于美国属正常 [1]。
  • 人人都要身份验证：政府签发的带照片证件 + 180 天内地址证明，信息须与文件完全一致 [2]。
  • 不再需要 AWS IAM 与签名：自 2023-10-02 起只需 LWA access token，适用于所有区域 [3]。
  • Client Secret 每 180 天轮换：逾期未轮换，调用会报错 [4]。
  • 费用已取消：2025-11-03 宣布的年费与 GET 调用费，先推迟、后于 2026 年宣布目前不再推进；原公告也写明只为自己业务使用 SP-API 的卖家不收取额外费用 [14][15][5]。以官方最新公告为准。
选对类型

私有开发者还是公共开发者？卖家给自己店铺用选私有

项目私有开发者（本教程）公共开发者
定义只把自己公司接入亚马逊 API [16]开发公开应用，供其他公司使用
授权方式在 SPP 或卖家中心点 Authorize app 自授权 [12]卖家通过 OAuth 授权 [17]
Appstore 上架不上架 [18]必须上架 [19]
网站要求无须有公开、可访问的网站 [19]
授权上限最多 10 个自授权 [13]另有规则

选错类型会触发公共开发者的网站审核与 Appstore 上架要求。开发者资料里的 Data Access 选 Private Developer。

凭证归属

申请下来的凭证归谁？放在哪里？

凭证归你。SP-API 与 Amazon Ads API 都由你以自己的名义申请，Client Secret 与 Refresh Token 属于你本人。亚马逊政策要求不得共享访问密钥或密码，也不得索取他人的访问密钥 [20][21]。琼仁智度的设计是：凭证只录入你电脑上的中转客户端并加密保存在本机，云端从不接收、从不存储；所有发往亚马逊的请求都从你自己的网络发出。授权方式与数据流向的完整说明见 API 授权与数据说明。

最后要录入中转客户端的 5 项

LWA Client ID、Client Secret、Refresh Token（机密，只存本机），以及 Marketplace ID（美国站 ATVPDKIKX0DER）与 Seller ID（账户标识，必填）[22]。录入方法见 安装中转客户端并录入凭证。

开始

SP-API 申请教程：5 步目录

① 准备资格与材料

专业销售计划、主账号、公司注册信息、证件与 180 天内地址证明。

打开这一步 →

② 注册与身份验证

在 Solution Provider Portal 注册，完成企业信息、PIN 与身份核验。

打开这一步 →

③ 填写开发者资料

私有开发者、最少的非受限角色、如实用例、安全问卷。

打开这一步 →

④ 建应用与自授权

创建草稿应用、查看 LWA 凭证、生成 Refresh Token。

打开这一步 →

⑤ 轮换、撤销与排错

每 180 天轮换 Client Secret、撤销授权、费用政策与报错排查。

打开这一步 →
拿到凭证之后

SP-API 凭证到手后，琼仁智度用它帮你做什么？

SP-API 提供的是订单、退款、库存、价格与费用这类经营数据，广告数据则来自 Amazon Ads API；两者按 ASIN 关联，才能算出广告花费占总销售的比例这类总账指标 [8]。PPCWISER 琼仁智度把两边的数据放进同一本账：

系统的算法按统一的广告结构运行：接入时你可以重构正在跑的广告系列（方案 A），或保留原系列另建一套标准结构（方案 B），见 广告结构说明。自己申请卡住了？可以选择 API 申请协助（¥499/次）：你本人登录并亲自操作，我们远程指导填写。

SP-API 申请常见问题

SP-API 申请要多久能批下来？
身份验证审核最多 2 个工作日，标准（非受限）角色的开发者资料审核通常 1–2 周 [2][6]。亚马逊来信追问时须在 5 天内回复，否则案件会被结案 [11]。
2026 年申请 SP-API 还要交年费吗？
目前不需要。亚马逊 2025-11-03 宣布的年费与调用费已于 2026 年宣布不再推进，SPP 中登记的信用卡可以删除 [5]；原公告也写明只为自己业务使用的卖家不收取额外费用 [14]。以官方最新公告为准。
申请 SP-API 还需要创建 AWS IAM 用户吗？
不需要。自 2023-10-02 起 SP-API 不再要求 AWS IAM 与 SigV4 签名，只用 LWA access token [3]。注意：Amazon Marketing Stream 需要 AWS，那是另一件事，见 AWS 教程。
员工的子账号可以申请 SP-API 吗？
不能。注册、自授权与轮换 Client Secret 都必须由主账号用户完成 [10][12][4]。如果主账号在老板手里，提前约好时间一起操作。
SP-API 申请表可以用中文填吗？
官方没有说明是否接受中文作答；政策文件有中文版但以英文版为准 [23]。我们建议用英文填写，各页都附了英文范本和中文对照。
SP-API 开发者资料被拒了怎么办？
页面会列出未满足的问题与控制项，修改后可重新提交开发者资料 [24]。常见原因与处理见 开发者资料填写。

凭证准备好，就可以开始 30 天免费试用

全部功能开放，试用期不收订阅费；之后入门版 ¥99/月/店铺（含 10 个产品），每多 1 个产品 +¥10/月。API 不想自己摸索？申请协助 ¥499/次，你本人操作、我们远程指导。

入门版 ¥99/月/店铺 · 含 10 个产品 · 每增加 1 个产品 +¥10/月
免费试用 30 天看价格与计算器
继续了解

相关功能

SP-API · 第 1 步

准备资格与材料

专业销售计划、主账号、公司信息、证件与 180 天内地址证明，一次备齐。

查看 →Ads API

Ads API 申请

Ads API 申请 5 步：安全配置文件、申请分配、授权换 Token、Profile ID、365 天续期。

查看 →接入教程

安装中转客户端

Windows 电脑双击安装、配对码上线，在本机设置页录入全部凭证，凭证不离开这台电脑。

查看 →服务

API 申请协助

¥499/次：你本人操作，我们远程指导 SP-API 与 Ads API 申请。

查看 →透明说明

API 授权与数据说明

凭证归属、调用方式、处理哪些数据与用途、申请表如何如实填写。

查看 →利润核算

真实净利账本

按实付价算账，扣全成本、退款与全部广告费；每一分利润经得起对账。

查看 →
REFERENCES

参考资料与权威来源

本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文；访问日期 2026-09。

  1. [1]官方Solution Provider Portal FAQ — Amazon Selling Partner API Docs · 2026开发者注册已迁移到 Solution Provider Portal，卖家中心的开发者入口会重定向到 SPP；SPP 为全球账户，界面显示账户位于美国属正常；身份验证对整个 SPP 账户只需做一次。
  2. [2]官方Verify Your Identity in Solution Provider Portal — Amazon Selling Partner API Docs · 2026所有 Solution Provider Portal 用户都须完成身份验证：政府签发的带照片证件 + 180 天内的地址证明（银行/信用卡账单或 Payoneer、World First、Alipay 等账单）；信息须与文件完全一致，提交后不可修改，审核最多 2 个工作日，结果为最终决定。
  3. [3]官方SP-API no longer requires AWS IAM or AWS Signature Version 4 — Amazon Selling Partner API Changelog · 2023自 2023-10-02 起，SP-API 不再要求 AWS IAM 资源与 AWS SigV4 签名，只需 LWA access token，适用于所有区域。
  4. [4]官方Rotate your Application's LWA Credentials — Amazon Selling Partner API Docs · 2026所有 SP-API 应用必须每 180 天轮换一次 LWA client secret，到期前 90 天收到通知；只有主账号用户能轮换；旧 secret 在生成新 secret 后 7 天失效；逾期未轮换调用会报错。
  5. [5]官方Cancellation of Third-Party Developer Selling Partner API (SP-API) Fees — Amazon Selling Partner Developer Services · 2026亚马逊宣布目前（at this time）不再推进 SP-API 使用费与年费，将从 Solution Provider Portal 移除费用预览，已登记的信用卡可删除。
  6. [6]官方Step 3: Create a Developer Profile — Amazon Selling Partner API Docs · 2026开发者资料包括联系信息、数据访问类型、角色、用例与安全控制问答；标准（非受限）角色审核通常 1–2 周，受限角色需经过业务、安全、技术三段审核。
  7. [7]官方Selling Partner API Roles — Amazon Selling Partner API Docs · 2026SP-API 按角色授权数据访问；Direct-to-Consumer Shipping、Tax Invoicing、Tax Remittance、Professional Services 四个角色为受限角色，可能涉及个人身份信息（PII）。
  8. [8]官方Ads + Selling Partner APIs Onboarding and Best Practices — Amazon Ads API Knowledge Hub · 2024TACOS = 广告花费 ÷ 总销售额（广告 + 自然），需要结合 Ads API 与 Selling Partner API 数据计算。
  9. [9]官方Access Orders PII — Amazon Selling Partner API Docs · 2026没有受限角色时，美国订单的买家姓名、地址、电话、邮箱等 PII 字段不会返回；订单金额、SKU、ASIN 等非 PII 数据不受影响。
  10. [10]官方SP-API Registration Overview — Amazon Selling Partner API Docs · 2026开发 SP-API 私有卖家应用需要专业销售账户（个人账户不行）；必须由主账号用户完成注册；开发者资料申请须原创、少于 500 词，不得照抄 AUP/DPP；安全控制问题应由负责数据安全的技术人员作答。
  11. [11]官方Register as a Private SP-API Developer — Amazon Selling Partner API Docs · 2026私有开发者只把本公司接入亚马逊 API；Data Access 选择 Private Developer；已迁移用户从 Solution Provider Portal 的 Settings → Developer Profile 进入；亚马逊来信追问须在 5 天内回复，否则案件结案。
  12. [12]官方Authorize Private Applications — Amazon Selling Partner API Docs · 2026私有应用在草稿状态即可自授权：点 Authorize app 生成 refresh token，每点一次生成新 token 且不使旧 token 失效；须为该卖家中心账户的 Primary User；token 应加密保存、不写入日志或 URL；运行时向 api.amazon.com/auth/o2/token 换取有效期通常 3600 秒的 access token。
  13. [13]官方Authorization Limits — Amazon Selling Partner API Docs · 2026私有应用最多 10 个自授权，达到上限后需先撤销旧授权才能新增。
  14. [14]官方An Update on SP-API Fees（2025-11-03 公告，Internet Archive 存档） — Amazon Selling Partner Developer Services · 20252025-11-03 亚马逊宣布拟向第三方开发者收取 SP-API 年费与 GET 调用使用费，并写明仅为自己业务直接使用 SP-API 的卖家不收取额外费用。
  15. [15]官方SP-API Fees Implementation Delayed（Internet Archive 存档 2026-03-26） — Amazon Selling Partner Developer Services · 20262026 年 3 月，亚马逊公告推迟 SP-API 费用的实施。
  16. [16]官方Terminology — Amazon Selling Partner API Docs · 2026官方术语：私有开发者只为自己公司构建集成；主账号用户是注册账户的所有者，拥有全部权限且不可转授。
  17. [17]官方Authorize Applications — Amazon Selling Partner API Docs · 2026私有应用只有在新增角色时才需要重新自授权；公共应用由卖家通过 OAuth 授权。
  18. [18]官方Getting Started with SP-API for Private Developers — Amazon Selling Partner Developer Services · 2026私有应用只供本组织使用、通过自授权接入，不在 Appstore 上架；开发私有卖家应用需要专业销售账户。
  19. [19]官方Register as a Public SP-API Developer — Amazon Selling Partner API Docs · 2026公共开发者须有公开可访问、介绍其服务的网站（不能在建设中、有安全警告或只有登录页），并须按 SPP 协议把应用上架 Selling Partner Appstore。
  20. [20]官方Acceptable Use Policy（SP-API） — Amazon Seller Central · 2026SP-API AUP：2.2 须对授权用户清楚、诚实地说明访问哪些数据及用途；提交给亚马逊的材料须准确；3.1 不得共享访问密钥或密码；3.2 不得出于任何目的索取或接收授权用户的访问密钥；3.3 不得索要卖家中心用户名密码；3.5 连续 90 天无成功调用的访问密钥会被删除；3.8 不得申请应用功能用不到的数据。
  21. [21]官方Data Protection Policy / Acceptable Use Policy（Amazon Ads API） — Amazon Ads · 2026Ads API 数据政策：切勿共享密钥或密码，切勿出于任何目的索要或接受广告参与者的访问凭证，不申请用不到的访问，应用须每 365 天重新取得用户同意，发现安全事件 24 小时内报告。
  22. [22]官方Store Identifiers（Marketplace IDs） — Amazon Selling Partner API Docs · 2026北美区域 Marketplace ID：美国 ATVPDKIKX0DER、加拿大 A2EUQ1WTGCTBG2、墨西哥 A1AM78C64UM0Y8、巴西 A2Q3Y263D00KWC；许多 SP-API 操作需用它指定目标站点。
  23. [23]官方Policies and Agreements — Amazon Selling Partner API Docs · 2026SP-API 的安全与合规框架由 Acceptable Use Policy、Data Protection Policy 与 Solution Provider Portal Agreement 三份文件构成；提供中文等语言版本，以英文版为准。
  24. [24]官方Developer Registration Request Status — Amazon Selling Partner API Docs · 2026审核期间页面显示注册审核中的横幅；未通过时页面会列出未满足的问题与控制项，修改后可重新提交开发者资料。