kenyipp / selling-partner-api-sdk

A fully typed TypeScript and Node.js SDK library for Amazon Selling Partner API

Selling Partner API for Node.js

---

• A fully typed TypeScript and Node.js SDK package for Amazon Selling Partner API
• Uses models from API model's repo to generate classes automatically
• Picks up changes and releases daily when/if models have drifted
• Based on Axios and uses aws4-axios interceptor to automatically sign the requests
• Can optionally assume roles via STS, and refresh STS credentials on schedule

Download & Installation

npm i -s @scaleleap/selling-partner-api-sdk

Getting Started

Prerequisites

A few things to get started:

• Registering as a developer
• Registering your Selling Partner API application
• Authorizing Selling Partner API applications

Basic Usage

The general format applies to any Selling Partner API request:

import { SellersApiClient } from '@scaleleap/selling-partner-api-sdk'

const client = new SellersApiClient({
  accessToken: 'Atza|...',

  // Or use `amazonMarketplaces.CA.sellingPartner.region.endpoint`
  // from `@scaleleap/amazon-marketplaces` package
  basePath: 'https://sellingpartnerapi-na.amazon.com',

  // Or use `amazonMarketplaces.CA.sellingPartner.region.awsRegion`
  // from `@scaleleap/amazon-marketplaces` package
  region: 'us-east-1',
})

const marketplaceParticipations = await client.getMarketplaceParticipations()

See the full list of exported classes and types: src/api-models/index.ts.

See @scaleleap/amazon-marketplaces docs for a database of constants about Amazon Marketplaces.

Documentation

• Automatically generated docs

Contributing

This repository uses Conventional Commit style commit messages.

Authors or Acknowledgments

• Roman Filippov (Scale Leap)
• Toan Nguyen (nguyentoanit)

License

This project is licensed under the MIT License.