Amazon Product Advertising API Developer's Manual page 55

Product Advertising API Developer Guide
Locale
IT
JP
UK
US
The endpoint remains the same for all Product Advertising API requests, as shown in the following
example.
http://webservices.amazon.com/onca/xml
The third and fourth lines identify the request submitter. The AWSAccessKey Id is required; it helps identify
the request submitter. You receive an AWS Access Key ID when you sign up with Product Advertising
API.
The other identifier, AssociateTag, is required. It is an ID for an Associate. If you are an Associate, you
must include your Associate tag in each request to be eligible to receive a referral fee for a customer's
purchase.
Request Terms that Change
The remaining terms in the request vary significantly according to the operation chosen. The terms,
however, follow a pattern, as shown in the next figure.
The Operation parameter is required. Its value is one of the Product Advertising API operations. These
operations are described throughout this guide.
The last lines, operation parameters, are representative of parameters that the operation requires, and
optional parameters that the operation can use. Requests can contain zero or more operation (up to ten)
parameters.These parameters are described in the discussion of each operation in the Product Advertising
API Reference Guide.
Response Groups
A special parameter that is optional for all Product Advertising API operations is ResponseGroup. Response
groups control the kind of information returned by the request. For example, the Large response group
returns a great deal of information about the items included in a response, whereas the Medium and
Small response groups return less.
Anatomy of a REST Request
Endpoint
http://webservices.amazon.it/onca/xml
https://webservices.amazon.it/onca/xml
http://ecs.amazonaws.jp/onca/xml
https://ecs.amazonaws.jp/onca/xml
http://ecs.amazonaws.co.uk/onca/xml
https://ecs.amazonaws.co.uk/onca/xml
http://webservices.amazon.com/onca/xml
https://webservices.amazon.com/onca/xml
API Version 2011-08-01
48