|
You are browsing the documentation for a deprecated version ('2014-08-15') of the Amazon Mechanical Turk Requester API. This version of the API will be deprecated and will be rendered unusable as of June 1st, 2019. If you request against a legacy API version (https://docs.aws.amazon.com/AWSMechTurk/latest/AWSMturkAPI-legacy/Welcome.html) on or after June 1, 2019, you will receive the following response:
The latest version of our API ('2017-01-17') provides you with additional tool choices and enables you to select from nine AWS Software Development Kits This version also updates naming conventions used in the API and adopts the AWS standard of Signature Version 4 to authenticate requests securely. The API uses REST requests and no longer requires that developers be familiar with SOAP protocol. These changes make the MTurk API consistent with AWS APIs, simplifying the on-boarding process for both new and existing AWS developers. The legacy MTurk Command Line Tools and .NET, Java, Ruby, and Perl SDKs were marked as deprecated in January 2018. We will be deprecating the legacy APIs as of June 1, 2019. If you are on a legacy API, you must migrate to the latest
version of our API. You can find documentation for the latest API here and the AWS SDKs here For support, contact requestor-apilegacydeprecation-support@amazon.com |
Common Parameters
The Amazon Mechanical Turk Service accepts a set of parameters in the request common to every operation. Each required parameter must be included in a request for the request to be successful. Parameters common to all operations are explained in Common Request Parameters. For more information about the parameters for a specific operation, see the description of the operation in the Operations section of this reference.
Response groups specify what data is returned by Mechanical Turk for an operation request and are explained in Response Groups.
Common Request Parameters
Requests to the Amazon Mechanical Turk service can include the parameters described in the following table. Required parameters must be included with each request for the request to succeed.
| Name | Description | Required |
|---|---|---|
|
|
The Requester's Access Key ID, a unique identifier that corresponds to a Secret Access Key and an Amazon.com account. Type: String Default: None |
Yes |
|
|
The name of the Amazon Web Services service. Type: String Valid Values: AWSMechanicalTurkRequester Default: None Constraints: For REST requests only. For SOAP requests the name of the service is part of the SOAP entry point, and does not need to be specified in the request. |
Yes |
|
|
The name of the operation. Type: String Default: None Contraints: For REST requests only For SOAP requests, the operation name is part of the SOAP message structure provided by your SOAP toolkit, and is not part of the request. |
Yes |
|
|
The signature for this request, an encrypted string calculated from elements of the
request and the AWS access key that corresponds to your AWS Access
Key ID. For information about how to calculate a
Type: String Default: None |
Yes |
|
|
The current time on your system. This value is included to validate
against the Type: a dateTime Default: None |
Yes |
|
|
A list of response groups. For more information about response groups, see Response Groups. Type: String Default: None |
Yes |
|
|
Specifies what version of the API to use. Type: String Default: None. If not specified, the latest version of the API is used. Constraints: Used only for REST requests |
No |
|
|
|
No |
|
|
This parameter is reserved for future use. Type: None Default: None |
Not used |
Response Groups
Response groups specify what data is returned by the service for an operation, to control
the data included in the response. Most operations in the Amazon Mechanical Turk service
allow the use of two common response groups: Minimal and
Request. Minimal provides a minimal set of results of the
operation call. Request echoes the content of the original request. What
gets included in Minimal varies depending upon the API call.
The following table lists the operations that can return more response groups than Minimal
and Request.
| Operation | Allowable Response Groups | Default Response Groups |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Response Groups Content
The following table lists the elements returned in the response groups other than the Minimal and Request groups.
The table also lists the response group elements associated with each response group.
| Response Group | Response Group Elements (alpha order) |
|---|---|
|
|
For more information on this element, see the Assignment data structure. |
|
|
For more information on these elements, see the HIT data structure. |
|
|
For more information on these elements, see the HIT data structure. |
|
|
For more information on this elements, see the HIT data structure. |
|
|
|
