还在手写卖家 API 调用从 OpenAPI 模型仓库到多语言 SDK 只要 3 步【免费下载链接】selling-partner-api-modelsThis repository contains OpenAPI models for developers to use when developing software to call Selling Partner APIs.项目地址: https://gitcode.com/gh_mirrors/se/selling-partner-api-models假设你刚拿到 Selling Partner API 的接口文档准备给自己的工具接入订单同步。打开发现要调通一个GET /orders/v0/orders光认证就有三道坎LWA 令牌、请求签名、x-amz-access-token请求头而订单、库存、报告、财务十几个 API 加起来有几百个接口每个都要手工封装 HTTP 调用、写序列化、处理错误码。这正是 Selling Partner API Models 存在的意义一个面向亚马逊卖家平台的 OpenAPI 模型仓库把全部接口契约集中管理配合代码生成器自动产出可调用的多语言 SDK把造轮子变成选轮子。它在你开发链路里的位置你可以把整个项目想象成一套乐高系统模型文件是图纸代码生成器是自动拼装流水线SDK 是拼好的零件盒你的业务代码才是最终成品。你不再需要从零理解每个接口的细节只需要挑一盒零件组装进自己的程序。Swagger 模型图纸 → Swagger Codegen拼装流水线 → 多语言 SDK零件盒 → 业务代码成品这个仓库只负责前两环models/目录存放所有 API 的 Swagger 2.0 定义clients/目录存放各语言的认证库与 Codegen 模板。搞清楚这点你就知道后续所有操作都围绕拿模型 → 跑生成器 → 得到 SDK展开。它能帮你做的三件事一份契约覆盖全部接口models/下按业务领域分目录存放了 40 个 API 的完整定义每个文件都遵循 Swagger 2.0 标准接口路径、参数、请求/响应结构、速率限制全部写死在里面。以订单 API 的ordersV0.json为例打开就能看到{ paths: { /orders/v0/orders: { get: { operationId: getOrders, parameters: [{ name: CreatedAfter, in: query, type: string }] } } } }直接给你结论这份契约就是官方认可的标准答案你的代码永远和亚马逊的接口定义保持同步不用再靠抓包猜字段。一条命令产出你熟悉语言的 SDK仓库为 Java、C#、JavaScript、Python、PHP 都备好了认证库和 Mustache 模板。以 JavaScript 为例一条命令就能把全部模型批量生成成 SDK# 1. 先下载 swagger-codegen-cli 2.4.29 的 jar 包版本很关键见绕坑指南 # 2. 进入 JavaScript 客户端目录安装依赖 cd clients/sellingpartner-api-aa-javascript/src npm install # 3. 一条命令生成全部 API 的 JS SDK ./generate-js-sdk.sh -j /path/to/swagger-codegen-cli-2.4.29.jar # -j 指向 jar 路径脚本自动拉取最新模型生成结果落在 sdk/ 目录脚本会遍历models/下每个模型文件逐个调用 Codegen 生成对应语言的客户端你只负责挑选自己要用的那部分。认证、限流、异常交给库而不是你生成的 SDK 集成了 LWALogin with Amazon认证链路获取令牌、签名请求、自动附加请求头都是现成的。Java 侧最典型的一段写法// 配置 LWA 凭据clientId 与 clientSecret 来自卖家中心的开发者应用 LWAAuthorizationCredentials credentials LWAAuthorizationCredentials.builder() .clientId(your-client-id) .clientSecret(your-client-secret) .refreshToken(your-refresh-token) .endpoint(https://api.amazon.com/auth/o2/token) .build(); // 签名器会把访问令牌注入请求你只负责发起调用 Request signed new LWAAuthorizationSigner(credentials).sign(originalRequest);此外库内还内置了访问令牌缓存避免频繁换 token和RateLimitConfiguration客户端限流这些在裸调用里都要自己写。30 分钟跑通第一个接口从零到拿到第一个真实响应核心就三步# 1. 克隆模型仓库含 models 与 clients 全部内容 git clone https://gitcode.com/gh_mirrors/se/selling-partner-api-models接着下载 swagger-codegen-cli 2.4.29 的 jar 包按上面的脚本生成 JS SDK。然后写调用代码关键只有三行// 一行初始化客户端一行注入认证一行拿数据 const client new ApiClient(https://sellingpartnerapi-na.amazon.com); client.enableAutoRetrievalAccessToken(client ID, client secret, refresh token); const result await new SellersApi(client).getMarketplaceParticipations();enableAutoRetrievalAccessToken会自动完成 LWA 换 token 并注入x-amz-access-token请求头你的业务代码只剩调用方法、拿结果。用沙盒环境sandbox.sellingpartnerapi-na.amazon.com测试还能避开真实数据的影响。绕坑指南过来人的四条血泪经验坑 1Codegen 版本乱升级生成直接失败现象SDK 生成到一半报错或产物缺类。原因SP-API 模型对 swagger-codegen 3.x 存在已知兼容性问题。解法固定使用 2.4.29别用更新的版本。坑 2凭据与端点配错永远 401/403现象令牌拿到了但请求仍被拒绝。原因clientId、clientSecret、refreshToken三项来自卖家中心的应用配置端点则区分生产与沙盒混用必挂。解法逐项对照应用信息填写先拿沙盒端点验证一遍再上生产。坑 3忽略速率限制接口频繁 429现象跑批任务时大量请求被节流。原因每个操作在模型里都声明了 rate/burst如订单查询 0.0167 次/秒超过即触发限流。解法用库内RateLimitConfiguration在客户端侧限流配合重试逻辑。坑 4个别模型天生带病生成 SDK 必炸现象生成 Merchant Fulfillment V0 时报致命错误。原因该模型里AvailableFormatOptionsForLabel的引用写法在 JS 模板下不兼容。解法按 README 指引手工替换该字段后再生成生成时对是否重新拉取模型回答 n避免覆盖你的修改。手写 vs 生成差在哪对比维度手写 HTTP 调用用此项目生成 SDK首次接入耗时数天签名、序列化、分页全手写数小时生成 配凭据新增 API 支持每个接口手写一遍重新生成即得认证与限流自己实现并持续调试客户端库内置出错率字段名、类型错漏频繁与模型严格对应编译期暴露版本同步人工核对变更日志拉新模型重新生成下一步动手✅ 3 步拿到全量多语言 SDK告别手工封装✅ 认证、限流、异常处理开箱即用✅ 接口契约永远和官方定义同步⚡ 复制上面的 clone 命令30 秒后你的sdk/目录里就有第一个客户端把仓库克隆下来后先打开clients/下对应语言的 README——每个目录都写明了生成步骤和示例代码。跑通第一个接口你会发现自己从此再也没必要手写那些重复的 HTTP 模板代码了。【免费下载链接】selling-partner-api-modelsThis repository contains OpenAPI models for developers to use when developing software to call Selling Partner APIs.项目地址: https://gitcode.com/gh_mirrors/se/selling-partner-api-models创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 还在手写卖家 API 调用？从 OpenAPI 模型仓库到多语言 SDK 只要 3 步
还在手写卖家 API 调用从 OpenAPI 模型仓库到多语言 SDK 只要 3 步【免费下载链接】selling-partner-api-modelsThis repository contains OpenAPI models for developers to use when developing software to call Selling Partner APIs.项目地址: https://gitcode.com/gh_mirrors/se/selling-partner-api-models假设你刚拿到 Selling Partner API 的接口文档准备给自己的工具接入订单同步。打开发现要调通一个GET /orders/v0/orders光认证就有三道坎LWA 令牌、请求签名、x-amz-access-token请求头而订单、库存、报告、财务十几个 API 加起来有几百个接口每个都要手工封装 HTTP 调用、写序列化、处理错误码。这正是 Selling Partner API Models 存在的意义一个面向亚马逊卖家平台的 OpenAPI 模型仓库把全部接口契约集中管理配合代码生成器自动产出可调用的多语言 SDK把造轮子变成选轮子。它在你开发链路里的位置你可以把整个项目想象成一套乐高系统模型文件是图纸代码生成器是自动拼装流水线SDK 是拼好的零件盒你的业务代码才是最终成品。你不再需要从零理解每个接口的细节只需要挑一盒零件组装进自己的程序。Swagger 模型图纸 → Swagger Codegen拼装流水线 → 多语言 SDK零件盒 → 业务代码成品这个仓库只负责前两环models/目录存放所有 API 的 Swagger 2.0 定义clients/目录存放各语言的认证库与 Codegen 模板。搞清楚这点你就知道后续所有操作都围绕拿模型 → 跑生成器 → 得到 SDK展开。它能帮你做的三件事一份契约覆盖全部接口models/下按业务领域分目录存放了 40 个 API 的完整定义每个文件都遵循 Swagger 2.0 标准接口路径、参数、请求/响应结构、速率限制全部写死在里面。以订单 API 的ordersV0.json为例打开就能看到{ paths: { /orders/v0/orders: { get: { operationId: getOrders, parameters: [{ name: CreatedAfter, in: query, type: string }] } } } }直接给你结论这份契约就是官方认可的标准答案你的代码永远和亚马逊的接口定义保持同步不用再靠抓包猜字段。一条命令产出你熟悉语言的 SDK仓库为 Java、C#、JavaScript、Python、PHP 都备好了认证库和 Mustache 模板。以 JavaScript 为例一条命令就能把全部模型批量生成成 SDK# 1. 先下载 swagger-codegen-cli 2.4.29 的 jar 包版本很关键见绕坑指南 # 2. 进入 JavaScript 客户端目录安装依赖 cd clients/sellingpartner-api-aa-javascript/src npm install # 3. 一条命令生成全部 API 的 JS SDK ./generate-js-sdk.sh -j /path/to/swagger-codegen-cli-2.4.29.jar # -j 指向 jar 路径脚本自动拉取最新模型生成结果落在 sdk/ 目录脚本会遍历models/下每个模型文件逐个调用 Codegen 生成对应语言的客户端你只负责挑选自己要用的那部分。认证、限流、异常交给库而不是你生成的 SDK 集成了 LWALogin with Amazon认证链路获取令牌、签名请求、自动附加请求头都是现成的。Java 侧最典型的一段写法// 配置 LWA 凭据clientId 与 clientSecret 来自卖家中心的开发者应用 LWAAuthorizationCredentials credentials LWAAuthorizationCredentials.builder() .clientId(your-client-id) .clientSecret(your-client-secret) .refreshToken(your-refresh-token) .endpoint(https://api.amazon.com/auth/o2/token) .build(); // 签名器会把访问令牌注入请求你只负责发起调用 Request signed new LWAAuthorizationSigner(credentials).sign(originalRequest);此外库内还内置了访问令牌缓存避免频繁换 token和RateLimitConfiguration客户端限流这些在裸调用里都要自己写。30 分钟跑通第一个接口从零到拿到第一个真实响应核心就三步# 1. 克隆模型仓库含 models 与 clients 全部内容 git clone https://gitcode.com/gh_mirrors/se/selling-partner-api-models接着下载 swagger-codegen-cli 2.4.29 的 jar 包按上面的脚本生成 JS SDK。然后写调用代码关键只有三行// 一行初始化客户端一行注入认证一行拿数据 const client new ApiClient(https://sellingpartnerapi-na.amazon.com); client.enableAutoRetrievalAccessToken(client ID, client secret, refresh token); const result await new SellersApi(client).getMarketplaceParticipations();enableAutoRetrievalAccessToken会自动完成 LWA 换 token 并注入x-amz-access-token请求头你的业务代码只剩调用方法、拿结果。用沙盒环境sandbox.sellingpartnerapi-na.amazon.com测试还能避开真实数据的影响。绕坑指南过来人的四条血泪经验坑 1Codegen 版本乱升级生成直接失败现象SDK 生成到一半报错或产物缺类。原因SP-API 模型对 swagger-codegen 3.x 存在已知兼容性问题。解法固定使用 2.4.29别用更新的版本。坑 2凭据与端点配错永远 401/403现象令牌拿到了但请求仍被拒绝。原因clientId、clientSecret、refreshToken三项来自卖家中心的应用配置端点则区分生产与沙盒混用必挂。解法逐项对照应用信息填写先拿沙盒端点验证一遍再上生产。坑 3忽略速率限制接口频繁 429现象跑批任务时大量请求被节流。原因每个操作在模型里都声明了 rate/burst如订单查询 0.0167 次/秒超过即触发限流。解法用库内RateLimitConfiguration在客户端侧限流配合重试逻辑。坑 4个别模型天生带病生成 SDK 必炸现象生成 Merchant Fulfillment V0 时报致命错误。原因该模型里AvailableFormatOptionsForLabel的引用写法在 JS 模板下不兼容。解法按 README 指引手工替换该字段后再生成生成时对是否重新拉取模型回答 n避免覆盖你的修改。手写 vs 生成差在哪对比维度手写 HTTP 调用用此项目生成 SDK首次接入耗时数天签名、序列化、分页全手写数小时生成 配凭据新增 API 支持每个接口手写一遍重新生成即得认证与限流自己实现并持续调试客户端库内置出错率字段名、类型错漏频繁与模型严格对应编译期暴露版本同步人工核对变更日志拉新模型重新生成下一步动手✅ 3 步拿到全量多语言 SDK告别手工封装✅ 认证、限流、异常处理开箱即用✅ 接口契约永远和官方定义同步⚡ 复制上面的 clone 命令30 秒后你的sdk/目录里就有第一个客户端把仓库克隆下来后先打开clients/下对应语言的 README——每个目录都写明了生成步骤和示例代码。跑通第一个接口你会发现自己从此再也没必要手写那些重复的 HTTP 模板代码了。【免费下载链接】selling-partner-api-modelsThis repository contains OpenAPI models for developers to use when developing software to call Selling Partner APIs.项目地址: https://gitcode.com/gh_mirrors/se/selling-partner-api-models创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考