JavaScript SDK 用于销售合伙人 API
点击图像观看视频 .
JavaScript的销售伙伴API SDK使您能够轻松地将您的JavaScript/Node.js应用程序连接到亚马逊基于REST的销售伙伴API.
开始
全权证书
在使用SDK之前,需要注册为销售伙伴API开发商. 如果你还没有这样做, 请遵守指示 SP-API 登记概况。 。 。 . 您还需要注册您的申请,才能获得有效的证书来拨打SP-API. 如果你还没有做到这一点, 请遵守指示英寸 正在注册您的申请。 。 。 . 如果您已经成功注册, 您可以找到如何查看您的证书的指令 查看您的应用程序信息和证书。 。 。 .
最低要求
运行SDK需要节点版14或更高.
安装 SDK
使用 npm :
npm install @amazon-sp-api-release/amazon-sp-api-sdk-js
使用线条 :
yarn add @amazon-sp-api-release/amazon-sp-api-sdk-js
添加为包依赖
添加以下一行到 dependencies 在你身边 package.json 文件 :
"@amazon-sp-api-release/amazon-sp-api-sdk-js": "^1.0.0"
使用 SDK
要调用销售伙伴API中包含的API之一,您需要:
- 配置证书( 注: 使用您的个人证书进行
clientId, (中文(简体) ),clientSecret财务报告和审定财务报表refreshToken(中文(简体) ) - 启用自动
accessToken使用我们构建的 ApiClient 函数 OR 检索accessToken使用我们的LwaAuthClient帮助( 注意一些 API, 您需要额外的步骤才能获得)RDT Token(中文(简体) ) - 创建特定 API 和 API 客户端的示例,然后应用
accessToken对它. - 调用 API 操作
例如,参考以下连接到Sellers API的样本代码:
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('<YOUR_CLIENT_ID>','<YOUR_CLIENT_SECRET>', '<YOUR_REFRESH_TOKEN>', 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+ 导入/导出语法, 如示例代码所示 :
import {
SellersSpApi,
} from '@amazon-sp-api-release/amazon-sp-api-sdk-js';
提供反馈
我们需要你的帮助 使这个SDK伟大。 请参加社区活动,通过提交问题、参加讨论论坛和通过下列渠道提交拉动请求,为这项工作作出贡献: