# @amazon-sp-api-release/amazon-sp-api-sdk-js 中文文档 规范地址：https://npmcn.com/package/%40amazon-sp-api-release/amazon-sp-api-sdk-js/ 版本：1\.14\.0 npm 元数据更新时间：2026-11-03T13:48:58.296Z 中文译文更新时间：2026-11-05T23:57:42.757Z 软件包许可：Apache License 2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40amazon-sp-api-release/amazon-sp-api-sdk-js 原文对照：https://npmcn.com/package/%40amazon-sp-api-release/amazon-sp-api-sdk-js/?lang=original 项目主页：https://github.com/amzn/selling-partner-api-sdk#readme 源码仓库：https://github.com/amzn/selling-partner-api-sdk ## 关键信息（来自 npm 元数据） - 包体积（解压后）：18 MB，6874 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=14\.18\.0 - 运行依赖：4 个 - 首次发布：2025-04-07T11:49:10.871Z - 最新版本发布：2026-11-03T13:48:57.947Z - 近 30 天下载量：33136（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：28（近 12 个月 13 个） ## 中文简介 这个软件包正在销售合作伙伴API Javascript SDK,用于与LWA图书馆的节点JS. ## 安装 ```sh npm install @amazon-sp-api-release/amazon-sp-api-sdk-js ``` 也可以使用：`pnpm add @amazon-sp-api-release/amazon-sp-api-sdk-js`、`yarn add @amazon-sp-api-release/amazon-sp-api-sdk-js`、`bun add @amazon-sp-api-release/amazon-sp-api-sdk-js` ## README ## JavaScript SDK 用于销售合伙人 API [![npm version](https://badge.fury.io/js/@amazon-sp-api-release%2Famazon-sp-api-sdk-js.svg)](https://www.npmjs.com/package/@amazon-sp-api-release/amazon-sp-api-sdk-js) [![Video Thumbnail](https://github.com/amzn/selling-partner-api-sdk/blob/main/javascript/docs/video-thumbnail.png?raw=true)](https://www.youtube.com/watch?v=5pRZXYhjNIQ) _点击图像观看视频 ._ JavaScript的销售伙伴API SDK使您能够轻松地将您的JavaScript/Node.js应用程序连接到亚马逊基于REST的销售伙伴API. - [更多地了解出售伙伴API](https://developer.amazonservices.com/) - [出售伙伴 API 文档](https://developer-docs.amazon.com/sp-api/) ### 开始 #### 全权证书 在使用SDK之前,需要注册为销售伙伴API开发商. 如果你还没有这样做, 请遵守指示 [SP-API 登记概况](https://developer-docs.amazon.com/sp-api/docs/sp-api-registration-overview)。 。 。 . 您还需要注册您的申请,才能获得有效的证书来拨打SP-API. 如果你还没有做到这一点, 请遵守指示英寸 [正在注册您的申请](https://developer-docs.amazon.com/sp-api/docs/registering-your-application)。 。 。 . 如果您已经成功注册, 您可以找到如何查看您的证书的指令 [查看您的应用程序信息和证书](https://developer-docs.amazon.com/sp-api/docs/viewing-your-application-information-and-credentials)。 。 。 . #### 最低要求 运行SDK需要节点版14或更高. #### 安装 SDK 1. 查找最新版本编号 [这里](https://github.com/amzn/selling-partner-api-sdk/releases)。 。 。 . 2. 将依赖性添加到您的工程中( 请参见指令 [无](https://npmcn.com/package/%40amazon-sp-api-release/amazon-sp-api-sdk-js/#readme-using-npm), (中文(简体) ), [线条](https://npmcn.com/package/%40amazon-sp-api-release/amazon-sp-api-sdk-js/#readme-using-yarn) 财务报告和审定财务报表 [添加为包依赖](https://npmcn.com/package/%40amazon-sp-api-release/amazon-sp-api-sdk-js/#readme-add-as-an-package-dependency) 页:1. ##### 使用 npm : ```bash npm install @amazon-sp-api-release/amazon-sp-api-sdk-js ``` ##### 使用线条 : ```bash yarn add @amazon-sp-api-release/amazon-sp-api-sdk-js ``` ##### 添加为包依赖 添加以下一行到 `dependencies` 在你身边 `package.json` 文件 : ```bash "@amazon-sp-api-release/amazon-sp-api-sdk-js": "^1.0.0" ``` ### 使用 SDK 要调用销售伙伴API中包含的API之一,您需要: 1. 配置证书( 注: 使用您的个人证书进行 `clientId`, (中文(简体) ), `clientSecret` 财务报告和审定财务报表 `refreshToken`(中文(简体) ) 2. 启用自动 `accessToken` 使用我们构建的 ApiClient 函数 OR 检索 `accessToken` 使用我们的 `LwaAuthClient` 帮助( 注意一些 API, 您需要额外的步骤才能获得) `RDT Token`(中文(简体) ) 3. 创建特定 API 和 API 客户端的示例,然后应用 `accessToken` 对它. 4. 调用 API 操作 例如,参考以下连接到Sellers API的样本代码: ```javascript import { SellersSpApi } from '@amazon-sp-api-release/amazon-sp-api-sdk-js'; async function getMarketplaceParticipations() { try { //Configure Sellers ApiClient const sellersApiClient = new SellersSpApi.ApiClient(AppConfig.spApiNAEndpoint); sellersApiClient.enableAutoRetrievalAccessToken('','', '', null); const sellersApi = new SellersSpApi.SellersApi(sellersApiClient); //Call GetMarkerplaceParticipations API const participations = await sellersApi.getMarketplaceParticipations(); console.log( JSON.stringify(participations, null, ' ') + '\n**********************************' ) } catch (error) { console.error('Exception when calling getMarketplaceParticipations API', error.message); } } getMarketplaceParticipations(); ``` 或者,你可以去 `@amazon-sp-api-release/amazon-sp-api-sdk-js/sample-node-app` 复制并修改 `index.js` 财务报告和审定财务报表 `app.config.mjs` 让他们试试看 可以看到多个API操作调用样本,并有各种取回符号的方法,以及制作API调用时如何设置速率限制器并重试逻辑. 请注意, 速率限制器是默认打开的, 以保护您的 API 电话不被 429 个错误 . ##### 附加说明: 这个亚马逊销售伙伴API JavaScript SDK完全兼容ECMAScript模块(ESM). 您可以使用现代 ES6+ 导入/导出语法, 如示例代码所示 : ```javascript import { SellersSpApi, } from '@amazon-sp-api-release/amazon-sp-api-sdk-js'; ``` ### 提供反馈 我们需要你的帮助 使这个SDK伟大。 请参加社区活动,通过提交问题、参加讨论论坛和通过下列渠道提交拉动请求,为这项工作作出贡献: 提交 [问题](https://github.com/amzn/selling-partner-api-sdk/issues/new/choose) - 这是与我们团队互动的首选频道 描述您的特性请求, 或高调已有的 [问题](https://github.com/amzn/selling-partner-api-sdk/issues) 页 次 ## 常见问题 ### @amazon-sp-api-release/amazon-sp-api-sdk-js 是什么？ 这个软件包正在销售合作伙伴API Javascript SDK,用于与LWA图书馆的节点JS\. ### 如何安装 @amazon-sp-api-release/amazon-sp-api-sdk-js？ 在项目目录运行 npm install @amazon-sp-api-release/amazon-sp-api-sdk-js，或使用 pnpm add / yarn add / bun add。 ### @amazon-sp-api-release/amazon-sp-api-sdk-js 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/amazon-sp-api-release\_\_amazon-sp-api-sdk-js 是否存在。 ### @amazon-sp-api-release/amazon-sp-api-sdk-js 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @amazon-sp-api-release/amazon-sp-api-sdk-js 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=14\.18\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @amazon-sp-api-release/amazon-sp-api-sdk-js 可以商用吗？ @amazon-sp-api-release/amazon-sp-api-sdk-js 使用 Apache License 2\.0 许可。声明的许可为 Apache License 2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @amazon-sp-api-release/amazon-sp-api-sdk-js 的下载量有多少？ 根据 npm 官方下载统计，@amazon-sp-api-release/amazon-sp-api-sdk-js 在 2026/10/06 – 2026/11/04 这 30 天内被下载 33,136 次，日均约 1,105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @amazon-sp-api-release/amazon-sp-api-sdk-js 还在维护吗？ 最新版本 1\.14\.0 发布于 2026/11/03（2 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 13 个；首次发布于 2025/04/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。