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
        }
      ]
    }
  ]
}