Fast responses
Overview
You can ban a Toloker who responds too quickly. To do this, set key values in the quality_control.configs
array in the pool settings.
Request body
In the example below, the Toloker is blocked from accessing the task suites if 4 out of 10 responses were given too quickly. The minimum response time is 3 seconds.
You can ban a Toloker from your project for a given number of days, hours, minutes (at a time or in total) or permanently.
Ban for 10 days
{
"configs": [
{
"collector_config": {
"type": "ASSIGNMENT_SUBMIT_TIME",
"parameters": {
"history_size": 10,
"fast_submit_threshold_seconds": 3
}
},
"rules": [
{
"conditions": [
{
"key": "total_submitted_count",
"operator": "EQ",
"value": 10
},
{
"key": "fast_submitted_count",
"operator": "GTE",
"value": 4
}
],
"action": {
"type": "RESTRICTION_V2",
"parameters": {
"scope": "PROJECT",
"duration_unit": "DAYS",
"duration": 10,
"private_comment": "More than 4 quick responses"
}
}
}
]
}
]
}
To set a different ban period, change the applicable parameter for the action
key:
{
...
"action": {
"type": "RESTRICTION_V2",
"parameters": {
"scope": "PROJECT",
"duration_unit": "HOURS",
"duration": 12,
"private_comment": "More than 4 quick responses"
}
}
...
}
{
...
"action": {
"type": "RESTRICTION_V2",
"parameters": {
"scope": "PROJECT",
"duration_unit": "MINUTES",
"duration": 30,
"private_comment": "More than 4 quick responses"
}
}
...
}
{
...
"action": {
"type": "RESTRICTION_V2",
"parameters": {
"scope": "PROJECT",
"duration_unit": "PERMANENT",
"private_comment": "More than 4 quick responses"
}
}
...
}
Parameter |
Overview |
configs[] |
array of objects | required Array of quality control settings. |
configs.collector_config |
object | required Parameters for collecting statistics (for example, the number of tasks skipped in the pool). |
configs.collector_config.type |
string | required Criteria for the quality control rule:
|
configs.collector_config. parameters.fast_submit_ threshold_seconds |
integer | required The minimum acceptable response time, in seconds. |
configs.collector_config. parameters.history_size |
integer | required The maximum number of the Toloker's recent responses in the project to use for calculating the percentage of correct responses. If this field is omitted, the calculation is based on all the Toloker's responses in the pool. |
configs.rules.conditions |
object | required Conditions (for example, 10 task suites skipped in a row). Multiple conditions are combined with the "OR" operator. |
configs.rules.conditions.key |
string | required Values that are checked in the condition:
|
configs.rules.conditions. operator |
string | required Comparison operator (the
|
configs.rules.conditions. value |
integer | required The threshold value of the variable specified in |
configs.rules.action |
object | required The action to perform if conditions are met (for example, block access to the project). |
configs.rules.action.type |
string | required Type of action:
|
configs.rules.action. parameters |
object | required Action parameters. |
configs.rules.action. parameters.scope |
string | required Scope:
|
configs.collector_config. parameters |
object | required if Required if Parameters for collecting data (depends on the quality control rule specified in the |
configs.rules.action. parameters.skill_id |
string | required if Required if ID of the skill to update as tasks are completed. |
configs.rules.action. parameters.from_field |
string | required if Required if The value to assign to the skill:
|
configs.rules.action. parameters.skill_value |
integer | required if Required if A fixed value to assign to the skill (a number from 0 to 100). |
configs.rules.action. parameters.delta |
integer | required if Required if |
configs.rules.action. parameters.public_comment |
string | required if Required if Comments (the reason for rejecting responses). Available to the requester and the Toloker. |
configs.rules.action. parameters.duration_unit |
string Ban duration unit:
|
configs.rules.action. parameters.duration |
integer Ban duration. |
configs.rules. action.parameters. private_comment |
string Comments (the reason for blocking access). Visible only to the requester. |
configs.rules.action. parameters.open_pool |
boolean Determines whether to re-open a closed pool:
|