type="xs:string"
ref="tns:HTTPHeaders"
These abbreviations provide the namespace in which the parameters are defined.
Versioning
Product Advertising API enables you to specify the version of the WSDL you want to use. This functionality
ensures that future enhancements and changes to Product Advertising API WSDLs will not be intrusive
to your applications. For example, when Product Advertising API adds new elements to its WSDL,
applications that validate against an older Product Advertising API WSDLs will not be affected.
Product Advertising API WSDL version names are based on the date that they become active. The version
of the WSDL is specified in the Product Advertising API WSDL namespace declaration. In the preceding
example, the version of the WSDL is 2011-08-01.
xmlns:tns="http://webservices.amazon.com/
AWSECommerceService/2011-08-01"
In reality, the date, here, is the WSDL's file name.
The
AWSECommerceService
directory contains all of the Product Advertising API WSDL versions. You
use the
Version
parameter in REST requests to specify the version of the WSDL you want to use. The
default version is 2005-10-05. If you want to use a different WSDL version, including the latest, you must
specify it in each request, for example, in REST.
http://webservices.amazon.com/onca/xml?
Service=AWSECommerceService
&AWSAccessKeyId=
[AWS Access Key ID]
&Operation=ItemSearch&
SearchIndex=Books&
Author=Steve%20Davenport&
Version=2011-08-01
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]
Note
This version of the Product Advertising API Developer Guide describes all of the functionality of
the WSDL as of the guide's publication date. To read about older WSDLs, including the default
WSDL, refer to the older versions of this guide listed in the AWS Resource Center. Go to
http://aws.amazon.com/resources
.
SOAP requests always specify a namespace, which includes the WSDL version. To avoid problems due
to future WSDL changes, be sure to specify a WSDL version in your SOAP application.
Request Definitions
The Request Definitions segment of the WSDL defines Product Advertising API operation requests, as
shown in the following WSDL snippet.
<xs:complexType name="ItemSearchRequest">
<xs:sequence>
<xs:element name="Actor" type="xs:string" minOccurs="0" />
API Version 2011-08-01
16
Product Advertising API Developer Guide
What is a WSDL?
