Rate

Rate unrated Slot.

Request

PUT https://ttv.microworkers.com/api/v2/slots/{slotId}/rate

Parameters

Path Parameter    
Name Type Description
slotId string The ID of Slot.

Request Body

{
  "comment": string,
  "rating": string,
  "bonus": float,
  "taskScores": [
    {
      "taskId": string,
      "questionsScores": [
        {
          "questionId": string,
          "score": integer
        }
      ]
    }
  ]
}

RateSlotRequest

Property Type Description
rating string

Rating for unrated Slot. Required, if Campaign is not Qualification Test. [1]

  • OK – Satisfied
  • NOK – Not Satisfied
  • REVISE – Revise required.
comment string Comment to Worker. Required, if Rating is NOK or REVISE.
bonus float Bonus amount for Satisfied Slot. Value is in American $ and should be in range 10% to 200% of position cost. For example, if position cost is $0.10 - bonus amount must be in range from $0.01 to $0.20.
taskScores array[TasksScoreRequest] List of Tasks scores. [1] Required, if Campaign is Qualification Test, in all other cases must be omitted.

TasksScoreRequest

Property Type Description
taskId string The ID of Task.
questionsScores array[QuestionsScoreRequest] List of scores for Worker’s Answer to Questions.

QuestionsScoreRequest

Property Type Description
questionId string Question ID.
score integer Score for Worker’s Answer. Value in range 0 to 5.

Response

Response HTTP Codes

Http Code Response Type Description
204   No Content (OK)
400   Validation Failed
401   Unauthorized
403   Access denied
404   Not found

Examples

Rate slot as Satisfied

To rate slot as Satisfied in it’s just enough to provide a rating as OK, like in example below.

{
  "rating": "OK"
}

Rate slot as Satisfied and give bonus

When you rate slot as Satisfied you may optionally provide a comment to Worker and/or give a bonus. Bonus amount is value in American $. In example below we rate slot as Satisfied and give $0.15 bonus to Worker.

{
  "rating": "OK",
  "bonus": 0.15,
  "comment": "Good job!"
}

Rate slot as Not Satisfied

If you are not Satisfied with submitted proof, you must provide a comment what the problem was and rating as NOK, like in example below.

{
  "rating": "NOK",
  "comment": "You failed, because you didn't follow instructions."
}

Rate slot as Revise

If you are partially not Satisfied with submitted proof and want to give Worker another chance, you can rate slot as Revise. You must provide explanations to Worker how to revise proof in comment. rating value should be REVISE, like in example below. Note that once you allow a Worker to revise a slot, you may only be able to provide a new rating once the revised slot is resubmitted (maximum 48 hours).

{
  "rating": "REVISE",
  "comment": "You have to provide both website title and URL where you have found matching product."
}

Rate slot in Qualification Test Campaign [1]

To rate a slot in Qualification Test Campaign [1] you have to provide scores to Worker’s answers.

{
  "taskScores": [
    {
      "taskId": "1",
      "questionsScores": [
        {
          "questionId": "Q56ac304a3cf1a",
          "score": 5
        },
        {
          "questionId": "Q56ac304a3cf1b",
          "score": 4
        },
        {
          "questionId": "Q56ac304a3cf1c",
          "score": 0
        }
      ]
    }
  ]
}
[1]Microworkers Things-To-Know: Qualification Tests Microworkers Blog.