Introduction

This guide describes how to make a web service call to the Amazon Mechanical Turk Requester service. The guide discusses several programming languages and web services toolkits, and includes a complete code sample for each.

After reading this guide, you will be able to:

For more information about Amazon Mechanical Turk, including a complete description of the web service API, see the Amazon Mechanical Turk Developer Guide:

http://docs.amazonwebservices.com/AWSMechanicalTurkRequester/2006-10-31/

This guide walks you through a simple project that calls the Amazon Mechanical Turk web service and retrieves your account balance. The structure of the project is greatly simplified to illustrate the concepts and produce a complete, working program.

For your application, you might want to use a different structure. For example, you might want to put the routines that access the web service in a separate class or library file, then call them from your main routine.

This guide introduces several toolkits and libraries for making web service requests with various programming languages. For more information on how to use a toolkit or library, see its documentation. Links to some resources are listed in Next Steps.

This guide discusses 8 code samples in 6 languages, using either the SOAP or REST interfaces. You can use the links below to download complete ready-to-run samples from the Amazon Web Services Developer Connection web site.

LanguageInterfaceDownload

Java

SOAP

Link

C#

SOAP

Link

Perl

REST

Link

PHP

REST

Link

Python

REST

Link

Python

SOAP

Link

Ruby

REST

Link

Ruby

SOAP

Link

For a complete list of code samples, visit the Amazon Web Services Developer Connection web site:

http://developer.amazonwebservices.com/connect/kbcategory.jspa?categoryID=24

If you have already chosen the programming language and interface (SOAP or REST) that you want to use, you can hide the sections of this document that do not pertain to your language. On pages with language-specific information, a language selection menu appears in the upper-right corner of the page. Select your language to hide all others, or select All to show all sections.