Release Date: 2006-06-14
Latest WSDL/API Version: 2006-05-05
|New API version||
The latest version of the Mechanical Turk Requester Service
API is: 2006-05-05
To use the new API, make sure your application is specifying the API version in each request: SOAP users, upgrade your application to the latest WSDL. REST users, specify the Version parameter with a value of 2006-05-05 with each request, and use the latest schema. See the Developer Guide for more information.
|HIT event notifications||
You can now ask to be notified about events
regarding your HITs. When an event occurs, Mechanical Turk
can send you a human-readable e-mail message, or it can
attempt to contact your application directly with a web
Mechanical Turk can send a notification when a Worker accepts a HIT; when a Worker submits, returns or abandons an assignment; when an assignment is approved automatically due to the auto-approval delay; when a HIT becomes "reviewable", or; when a HIT expires. You establish notifications on a HIT type, so all HITs of a type will use the notification specification you provide. You can create or update a notification specification using the SetHITTypeNotification operation.
You can test your notification receptor web service using the SendTestEventNotification operation.
See the Developer Guide for more information on how to build a notification receptor web service. See the Resource Center for sample code for building a notification receptor.
|Include audio, video, Java applets and Flash movies in your HITs||You can now include audio and video clips, Java applets, and Flash movies in your HITs. As with images, you host the media files yourself, then provide a URL to the resource when you create your HIT.|
|Locale Qualification requirements||
You can now restrict a HIT to Workers living in a particular
country using a Qualification requirement. The locale
Qualification requirement matches against the primary address
provided by the Worker when the Worker's account was
Note: As part of this implementation, the Value parameter has been renamed IntegerValue in the Qualification requirement data structure and the GrantQualification, UpdateQualificationScore, and GetQualificationScore operations.
Mechanical Turk now supports UTF-8 encoding of the Unicode
character set for both question data and answer data. This
makes it easier to include text in non-English languages in
the question text, and accept text in non-English languages in
Note: The maximum field lengths described by the documentation refer to the number of bytes that can be stored in each field. In UTF-8 encoding, many Unicode characters are stored as more than one byte.
(This feature was released prior to 2006-06-14.)
If you have any questions or information regarding a potential bug, please let us know using the "Contact Us" form on the Requester web site. Visit http://requester.mturk.amazon.com/, select "FAQ" from the upper-right-hand corner, then select "Contact Us."