Soap Request Format

Your soap toolkit is responsible for formatting and sending requests based on the provided WSDL. This section shows what SOAP requests look like "on the wire".

Sample Non-batch Request

This is a sample non-batch SOAP request. Notice that the parameters Signature, Timestamp, and AWSAccessKeyId are identical to those in QUERY requests. The Action parameter however is specified in the element name in the form of <[Action]Request>.

<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 <SOAP-ENV:Body>
  <m:ThumbnailRequest
xmlns:m="http://ast.amazonaws.com/doc/2006-05-15/">
   <m:Request>
    <m:Signature>CekuNgi1Tg4AoXNgnQ6Ic4rAkPI=</m:Signature>
    <m:Timestamp>2006-01-01T00:00:00.000Z</m:Timestamp>
    <m:AWSAccessKeyId>1234567890ABCDFGHIJ</m:AWSAccessKeyId>
    <m:Url>www.alexa.com</m:Url>
   </m:Request>
  </m:ThumbnailRequest>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope> 
           

Sample Batch Request

This is a sample batch SOAP request with three service calls. Also, note that the Signature, Timestamp, and AWSAccessKeyId parameters need only be in the first <Request element.

<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 <SOAP-ENV:Body>
  <m:ThumbnailRequest
xmlns:m="http://ast.amazonaws.com/doc/2006-05-15/">
   <m:Request>
    <m:Signature>CekuNgi1Tg4AoXNgnQ6Ic4rAkPI=</m:Signature>
    <m:Timestamp>2006-01-01T00:00:00.000Z</m:Timestamp>
    <m:AWSAccessKeyId>1234567890ABCDFGHIJ</m:AWSAccessKeyId>
    <m:Url>www.alexa.com</m:Url>
   </m:Request>
   <m:Request>
    <m:Url>www.amazon.com</m:Url>
   </m:Request>
   <m:Request>
    <m:Url>www.a9.com</m:Url>
   </m:Request>
  </m:ThumbnailRequest>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
            

Parameter Details

The parameters in the example are described in the following table:

Parameter	Required	Description
AWSAccessKeyId	yes	This is your Amazon Web Services Access Key ID. This parameter is used to identify the sender of the request. Note: To obtain an AWS Access Key ID, you must sign up for an Amazon Web Services Account. To sign up, please use the sign in page.
Signature	yes	This parameter holds the computed signature for this request. Request signatures are used to authenticate requests, and assure that the request contents were not altered between the sender and AWS. For more information about request signatures, please see the Request Authentication section.
Url	required for Action=Thumbnail	This parameter is required when the action is Thumbnail, and tells the service what website to retrieve a thumbnail for. See the Thumbnail Action section for more information.
Size	optional for Action=Thumbnail	This parameter specifies the size of the thumbnail to be returned. Possible values are "Large" and "Small". When this parameter is not specified, defaults to "Large". See the Thumbnail Action section for more information.