Common Parameters

Introduction

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 here. For more information about the parameters for a specific operation, see the description of the operation in the Operations section of this reference.

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.

NameDescriptionRequired

AWSAccessKeyId

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

Service

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 bespecified in the request.

Yes

Operation

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

Signature

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 Signature, see MakingRequests_RequestAuthenticationArticle.

Type: String

Default: None

Yes

Timestamp

The current time on your system. This value is included to validate against the Signature parameter.

Type: a dateTime in the Coordinated Universal Time (Greenwich Mean Time) time zone, such as 2005-01-31T23:59:59Z.

Default: None

Yes

ResponseGroup

A list of response groups

Type: String

Default: None

Yes

Version

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

Validate

If specified, instructs the service to not perform the operation, and only return information about whether or not the request is valid.

Type: String

Default: None. If not specified, the service executes the requested operation.

No

Credential

This parameter is reserved for future use.

Type: None

Default: None

Not used