API-Related Information

This article contains the following information related to APIs.

• API Version
• Pagination Info
• Throttling Info
• Handling Errors

API Versions

Pagination Information

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 Information

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

Handling Errors

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’.