Prerequisites

Before you begin, you must create an Amazon Mechanical Turk Requester account, and set it up to use Amazon Web Services. You must also verify that you have installed the appropriate toolkits and libraries.

Before you can call the web service, you must have an Amazon Mechanical Turk Requester account, and you must register your account for use with Amazon Web Services.

Tip:

If you already have a Requester account, you can register for Amazon Web Services with the same e-mail address and password.

If you have an Amazon Web Services account but not a Requester account, you can register as a Requester with your AWS e-mail address and password.

To create a Requester account

  1. Go to the Amazon Mechanical Turk Requester web site:

    http://requester.mturk.amazon.com

  2. Click Register in the upper-right-hand corner.

  3. Enter your e-mail address.

    If you already have an Amazon.com account for your e-mail address, you can sign in using your e-mail address and password. However, we recommend creating a new account for use as a Requester.

  4. Follow the prompts to complete your Requester account registration. You will be prompted for your mailing address, and you will be asked to accept the Amazon Mechanical Turk Participation Agreement.

Before you can use the Amazon Mechanical Turk Requester web service, you must set up your Requester account with Amazon Web Services.

To set up your account for Amazon Web Services

  1. Go to the following URL:

    http://aws.amazon.com/register

  2. Enter the e-mail address and password for your Requester account.

  3. Follow the prompts to complete your AWS registration. You will be asked to accept the Amazon Web Services Licensing Agreement.

The code samples presented in this guide use libraries and toolkits to perform certain functions. Use the following steps to install the appropriate tools and verify that the code samples work with your environment.

The version numbers of the libraries and tools listed here represent the versions we have tested. In some cases, older versions might work. Newer versions usually work. Cases where a specific version is required are noted below.

Tip:

Don't forget: You can hide sections of this guide that do not apply to your programming language using the drop-down menu at the top of this page.

The Java code sample requires the following software.

SoftwareVersion TestedWeb Site

Java Development Kit

Java 2 Platform Standard Edition 1.4.2; also works with Java SE 5.

http://java.sun.com/

Apache Axis

1.4. Using a version prior to 1.4 might require different code.

http://ws.apache.org/axis/

Tip:

The ready-to-run Java code sample available from the AWS Developer Connection web site includes a script that builds, configures and runs the sample. The script requires Apache Ant (version 1.6.5 tested), which is available from the following web site:

http://ant.apache.org/

If you use the provided Apache Ant script, you do not need to add Apache Axis to your classpath. See the code sample's readme.txt file for more information.