This article contains the following information related to APIs.
- API Version
- Pagination Info
- Throttling Info
- Handling Errors
Amazon Marketplace Client Library Version
|Fulfillment Inventory||Version 2016-03-23|
Fulfillment Inbound Shipment
|Fulfillment Outbound Shipment||Version 2010-10-01|
If you make a request to Amazon Marketplace Web Service (Amazon MWS) that generates more response elements than the maximum number of response elements that can be returned per page, you can submit NextToken with a "ByNextToken" operation to request additional pages.
For example, ListOrders.bps returns max 100 orders at a time in the response. If there are more than 100 orders to be retrieved, a NextToken field will be made available in the ListOrders.bps response. This NextToken value can be used in the next Business Process call (ListOrdersByNextToken.bps) to retrieve the next set of orders. If NextToken is not returned, then there are no more orders.
For more information on Pagination please refer to the link: https://docs.developer.amazonservices.com/en_US/dev_guide/DG_NextToken.html
Throttling is the process of limiting the number of requests you can submit to a given operation in a given amount of time. A request can be when you submit an inventory feed or when you make an order report request. Throttling protects the web service from being overwhelmed with requests and ensures all authorized developers have access to the web service.
The throttling information which is x-mws-quota-max, x-mws-quota-remaining, x-mws-quota-resetsOn will be available in the responses of the Products, Feeds, Reports Business Process tasks only under ResponseHeaderMetadata section.
For more information on Throttling please refer to the link: https://docs.developer.amazonservices.com/en_US/dev_guide/DG_Throttling.html
In the Amazon Marketplace Connector, when the Connector BP task is successful, a response payload is returned.
If it fails, however, an error response payload is returned. The error payload will have the root as ‘ErrorResponse’.