Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

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 2013-08-01.

Copy
xmlns:tns="http://webservices.amazon.com/ AWSECommerceService/2013-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 2011-08-01. If you want to use a different WSDL version, including the latest, you must specify it in each request, for example, in REST.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate ID]& &Operation=ItemSearch& SearchIndex=Books& Author=Steve%20Davenport& Version=2013-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.

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.