mws-zodane-advanced
Version:
fixed throtal resend
321 lines (289 loc) • 12.1 kB
Markdown
# Getting Started
## Prerequisites
### Getting your MWS credentials
To use the MWS API, you will need to obtain your MWS API credentials. Amazon will supply three
items that you will need to provide: Access Key Id, Secret Access Key, and Merchant ID.
If you do not have an Amazon Seller Central "Professional" account, you will need that to get
started. Signing up for Seller Central and information related to that is beyond the scope of this
manual, see [Amazon Seller Central](http://sellercentral.amazon.com) for specifics.
When your Amazon Seller Central account is setup, navigate to the Settings menu (upper-right-corner)
and select "User Permissions" from the drop-down menu. After a few moments of waiting for the
entire page to finish loading, you should see a section titled "Amazon MWS Developer Permissions".
Note your Seller ID under the "Your Account Information" heading. Then, under the
"Current Authorizations" heading, you should see as the first line, your Developer ID, Store Name,
the date you created your API authorization, and a link titled "View your credentials".
Click "View your credentials", and a pop-up will appear with your Access Key ID. Make note of this,
then click "View" next to the "Secret Key" field. Make note of your Secret Access Key.
Now that you have your Access Key Id, Secret Access Key, and Merchant ID, you can begin using the
MWS API.
### Official MWS API documentation
You may find yourself wanting to refer to the official Amazon documentation, to determine how, when,
or why to use an API, or to find out information about what it returns, or what it is used for:
[Amazon MWS Web Service API Documentation](https://developer.amazonservices.com/gp/mws/docs.html)
## Installation
As mws-advanced is still under heavy initial development, it is not currently available from the
global npm repository. You should install it from the github repo, as:
````
npm install --save github:ericblade/mws-advanced
````
## Creating the connection to MWS
Before you are able to use the mws-advanced API, you must initialize it with your MWS credentials.
````
mws.init({
accessKeyId: 'Your Amazon MWS Access Key ID',
secretAccessKey: 'Your Amazon MWS Secret Access Key',
merchantId: 'Your Amazon MWS Merchant ID',
});
````
## Calling mws-advanced APIs
mws-advanced implements several wrappers around the actual MWS API, which parse and process the XML
responses from MWS into a response format that is more easily readable in Javascript.
````
(async function() {
const result = await mws.getMarketplaces();
console.log(result);
})();
````
will return data that should look something like this sample data from an account that is registered
in the United States and Canadian markets:
````
{
"markets": [
{
"MarketplaceId": "A2EUQ1WTGCTBG2",
"DefaultCountryCode": "CA",
"DomainName": "www.amazon.ca",
"Name": "Amazon.ca",
"DefaultCurrencyCode": "CAD",
"DefaultLanguageCode": "en_CA"
},
{
"MarketplaceId": "ATVPDKIKX0DER",
"DefaultCountryCode": "US",
"DomainName": "www.amazon.com",
"Name": "Amazon.com",
"DefaultCurrencyCode": "USD",
"DefaultLanguageCode": "en_US"
}
],
"marketParticipations": [
{
"MarketplaceId": "A2EUQ1WTGCTBG2",
"SellerId": "A3VRRE5P0AL2IX",
"HasSellerSuspendedListings": "No"
},
{
"MarketplaceId": "ATVPDKIKX0DER",
"SellerId": "A3VRRE5P0AL2IX",
"HasSellerSuspendedListings": "No"
}
],
"marketDetails": {
"A2EUQ1WTGCTBG2": {
"MarketplaceId": "A2EUQ1WTGCTBG2",
"DefaultCountryCode": "CA",
"DomainName": "www.amazon.ca",
"Name": "Amazon.ca",
"DefaultCurrencyCode": "CAD",
"DefaultLanguageCode": "en_CA",
"SellerId": "A3VRRE5P0AL2IX",
"HasSellerSuspendedListings": "No"
},
"ATVPDKIKX0DER": {
"MarketplaceId": "ATVPDKIKX0DER",
"DefaultCountryCode": "US",
"DomainName": "www.amazon.com",
"Name": "Amazon.com",
"DefaultCurrencyCode": "USD",
"DefaultLanguageCode": "en_US",
"SellerId": "A3VRRE5P0AL2IX",
"HasSellerSuspendedListings": "No"
}
}
}
````
This looks, in my opinion, far, far better than the raw result data that results from calling MWS
"ListMarketplaceParticipations" directly, which you will see an example for in the next section.
## Calling MWS APIs directly
For APIs that have not been wrapped, or if you wish to receive the raw data output from a direct
MWS API call for some reason, you can do that with the callEndpoint function:
````
(async function() {
const result = await mws.callEndpoint('ListMarketplaceParticipations');
console.log(result);
})();
````
For the same user that we called in the above "getMarketplaces" API, we receive the following data
back:
````
{
"ListMarketplaceParticipationsResponse": {
"$": {
"xmlns": "https://mws.amazonservices.com/Sellers/2011-07-01"
},
"ListMarketplaceParticipationsResult": [
{
"ListParticipations": [
{
"Participation": [
{
"MarketplaceId": [
"A1MQXOICRS2Z7M"
],
"SellerId": [
"A3VRRE5P0AL2IX"
],
"HasSellerSuspendedListings": [
"No"
]
},
{
"MarketplaceId": [
"A2EUQ1WTGCTBG2"
],
"SellerId": [
"A3VRRE5P0AL2IX"
],
"HasSellerSuspendedListings": [
"No"
]
},
{
"MarketplaceId": [
"A2ZV50J4W1RKNI"
],
"SellerId": [
"A3VRRE5P0AL2IX"
],
"HasSellerSuspendedListings": [
"No"
]
},
{
"MarketplaceId": [
"ATVPDKIKX0DER"
],
"SellerId": [
"A3VRRE5P0AL2IX"
],
"HasSellerSuspendedListings": [
"No"
]
}
]
}
],
"ListMarketplaces": [
{
"Marketplace": [
{
"MarketplaceId": [
"A1MQXOICRS2Z7M"
],
"DefaultCountryCode": [
"CA"
],
"DomainName": [
"siprod.stores.amazon.ca"
],
"Name": [
"SI CA Prod Marketplace"
],
"DefaultCurrencyCode": [
"CAD"
],
"DefaultLanguageCode": [
"en_CA"
]
},
{
"MarketplaceId": [
"A2EUQ1WTGCTBG2"
],
"DefaultCountryCode": [
"CA"
],
"DomainName": [
"www.amazon.ca"
],
"Name": [
"Amazon.ca"
],
"DefaultCurrencyCode": [
"CAD"
],
"DefaultLanguageCode": [
"en_CA"
]
},
{
"MarketplaceId": [
"A2ZV50J4W1RKNI"
],
"DefaultCountryCode": [
"US"
],
"DomainName": [
"sim1.stores.amazon.com"
],
"Name": [
"Non-Amazon"
],
"DefaultCurrencyCode": [
"USD"
],
"DefaultLanguageCode": [
"en_US"
]
},
{
"MarketplaceId": [
"ATVPDKIKX0DER"
],
"DefaultCountryCode": [
"US"
],
"DomainName": [
"www.amazon.com"
],
"Name": [
"Amazon.com"
],
"DefaultCurrencyCode": [
"USD"
],
"DefaultLanguageCode": [
"en_US"
]
}
]
}
]
}
],
"ResponseMetadata": [
{
"RequestId": [
"9994df75-e1ec-4a59-ae71-68538df26b65"
]
}
]
}
}
````
... what a big difference, right?
## Using your API access for a different Amazon Seller (authToken)
Amazon provides the ability to use the MWS API for different Amazon sellers, provided that they
have authorized you with the ability to access their API account, and have provided you with an
Authorization Token to do so. They can do this authorization via the same page that you received
your credentials from in the section titled "Getting your MWS Credentials". Once they provide you
with the Authorization Token and THEIR Merchant ID, then you can use mws-advanced to access their
account:
````
mws.init({
accessKeyId: 'Your Amazon MWS Access Key ID',
secretAccessKey: 'Your Amazon MWS Secret Access Key',
merchantId: 'THEIR MWS Merchant ID',
authToken: 'THEIR authorization token for you',
});
````