The SOAP Transport

The SOAP notification transport makes an HTTP connection to your notification receptor, and sends the notification message according to the SOAP web services standard.

The Destination that you specify in your notification specification is the "end point" (URL) Mechanical Turk will use for the SOAP request. In other words, this is the URL of your web service.

The SOAP API Mechanical Turk expects to use for notification messages is described by the notification WSDL. The location of the WSDL corresponds to the version of the API. For example, the WSDL for the 2006-08-23 version of the notification API is here:

http://mechanicalturk.amazonaws.com/AWSMechanicalTurk/2006-08-23/AWSMechanicalTurkRequesterNotification.wsdl

Mechanical Turk calls the Notify operation of this WSDL, using the end point you specified in the notification specification.

Parameters to the Notify operation call correspond to the parameters described in Elements of a Notification Message, such as Signature, Timestamp, and Version. Each event is represented in the SOAP request by a Event element, with sub-elements for each property of an event (such as EventTime).

<?xml version="1.0" encoding="UTF-8"?>
   <soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <soapenv:Body>
         <Notify xmlns="http://requester.mturk.amazonaws.com/doc/2006-08-23">
            <Signature>[signature generated from your secret key]</Signature>
            <Timestamp xsi:type="xsd:dateTime">2006-05-23T23:22:30Z</Timestamp>
            <Version>2006-08-23</Version>
            <Event>
               <EventType>AssignmentAccepted</EventType>
               <EventTime>2006-04-21T18:55:23Z</EventTime>
               <HITTypeId>KDSFO4455LKDAF3</HITTypeId>
               <HITId>KDSFO4455LKDAF3</HITId>
               <AssignmentId>KDSFO4455LKDAF3KDSFO4455LKDAF3</AssignmentId>
            </Event>
            <Event>
               <EventType>AssignmentReturned</EventType>
               <EventTime>2006-04-21T18:55:23Z</EventTime>
               <HITTypeId>KDSFO4455LKDAF3</HITTypeId>
               <HITId>KDSFO4455LKDAF3KDSFO4455LKDAF3</HITId>
               <AssignmentId>KDSFO4455LKDAF3KDSFO4455LKDAF3</AssignmentId>
            </Event>
         </Notify>
      </soapenv:Body>
   </soapenv:Envelope>