Amazon Mechanical Turk
API Reference (API Version 2012-03-25)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

QualificationRequest

Description

The QualificationRequest data structure represents a request a Worker has made for a Qualification.

The QualificationRequest data structure is used as a response element for the following operations:

Elements

The QualificationRequest structure can contain the elements described in the following table:

NameDescriptionRequired

QualificationRequestId

The ID of the Qualification request, a unique identifier generated when the request was submitted.

Type: String

Default: None

No

QualificationTypeId

The ID of the Qualification type the Worker is requesting, as returned by the CreateQualificationType operation.

Type: String

Default: None

No

SubjectId

The ID of the Worker requesting the Qualification. This ID corresponds to the WorkerId returned with assignment results when the Worker performs a HIT.

Type: String

Default: None

No

Test

The contents of the Qualification test that was presented to the , if the type has a test and the Worker has submitted answers. This value is identical to the QuestionForm associated with the Qualification type at the time the Worker requests the Qualification.

Type: a QuestionForm data structure

Default: None

No

Answer

The Worker's answers for the Qualification type's test contained in a QuestionFormAnswers document, if the type has a test and the Worker has submitted answers. If the Worker does not provide any answers, Answer may be empty.

Type: a QuestionFormAnswers data structure

Default: None

No

SubmitTime

The date and time the Qualification request had a status of Submitted. This is either the time the Worker submitted answers for a Qualification test, or the time the Worker requested the Qualification if the Qualification type does not have a test.

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

Default: None

No

Example

The following example shows a QualificationRequest data structure returned by the GetQualificationRequests operation. This operation returns the requests for Qualifications of a Qualification type to the owner of the type.

<QualificationRequest>
  <QualificationRequestId>789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE</QualificationRequestId>
  <QualificationTypeId>789RVWYBAZW00EXAMPLE</QualificationTypeId>
  <SubjectId>AZ3456EXAMPLE</SubjectId>
  <Test>
    &lt;QuestionForm&gt;
      [XML-encoded question data]
    &lt;/QuestionForm&gt;
  </Test>
  <Answer>
    &lt;QuestionFormAnswers&gt;
      [XML-encoded answer data]
    &lt;/QuestionFormAnswers&gt;
  </Answer>
  <SubmitTime>2005-12-01T23:59:59Z</SubmitTime>
</QualificationRequest>