Amazon Product Advertising API Developer's Manual page 4

Product Advertising API Developer Guide
Variation Parents ................................................................................................................ 41
Returning Variations ........................................................................................................... 41
Variation Images ....................................................................................................... 43
Variation Dimensions ......................................................................................................... 44
Accessories ................................................................................................................................. 44
Requests .............................................................................................................................................. 46
Anatomy of a REST Request ...................................................................................................... 46
Request Limitations ..................................................................................................................... 49
REST Syntax ............................................................................................................................... 49
Separator Characters ......................................................................................................... 50
Setting Parameter Values ................................................................................................... 50
Compound Parameters ............................................................................................. 50
SOAP Requests .......................................................................................................................... 51
The Structure of a SOAP Request ..................................................................................... 52
SOAP Endpoints ....................................................................................................... 52
The XML Message for an ItemSearch SOAP Request ............................................. 53
Request Authentication ............................................................................................................... 53
What Is Authentication? ..................................................................................................... 54
Your Product Advertising API Account ............................................................................... 54
Your AWS Identifiers .......................................................................................................... 54
Viewing Your AWS Identifiers ............................................................................................. 55
HMAC-SHA Signatures for REST Requests ...................................................................... 55
Authentication Parameters ....................................................................................... 56
Basic Authentication Process ................................................................................... 56
Authenticating REST Requests ......................................................................................... 57
Java Sample Code for Calculating Signature Version 2 Signatures ......................... 59
Example REST Requests ......................................................................................... 61
Authenticating SOAP Requests ......................................................................................... 66
Using SOAP with WS-Security ................................................................................. 66
Using SOAP without WS-Security ............................................................................ 71
Batch Requests ........................................................................................................................... 72
Batch Requests .................................................................................................................. 72
Parameters That Differ .............................................................................................. 73
Shared Parameters ................................................................................................... 74
Performing Multiple ItemLookups in One Request ................................................... 74
Parameters Common to All Product Advertising API Requests .................................................. 75
Required Parameters ......................................................................................................... 75
General, Optional Parameters ........................................................................................... 76
XSL Parameters ................................................................................................................. 76
XML-Encoding Parameters ................................................................................................ 77
Debugging Parameters ...................................................................................................... 77
Responses .................................................................................................................................. 77
Anatomy of a Response ..................................................................................................... 78
Version Information Segment ............................................................................................. 78
Operation Request Segment ............................................................................................. 79
Request Validation Segment .............................................................................................. 79
Paging and Sorting Through Responses ..................................................................................... 81
Paging Through Results ..................................................................................................... 81
Maximum Number Of Returned Pages .................................................................... 82
Sorting Results .................................................................................................................. 83
Default Sort Values ................................................................................................... 83
Finding Items to Buy ............................................................................................................................. 84
Search Operations ...................................................................................................................... 84
Items You Cannot Buy ................................................................................................................. 84
Availability Parameter ......................................................................................................... 85
Parameter Restrictions for Availability ...................................................................... 86
Items Sold by Merchants ............................................................................................................. 86
Required ItemSearch Parameters ...................................................................................... 87