Entering captchas

You can block access to tasks if a user incorrectly entered the captcha several times in a row. To do this, set key values in the quality_control.configs array in the pool settings.

Example for a JSON block

If a performer fails 7 out of 10 captchas, you may ban them from your project's tasks for a given number of days, hours, minutes (at a time or in total), or permanently.

Ban for 10 days
{
   "captcha_frequency": "LOW",
   "configs":[
      {
         "collector_config": {
            "type": "CAPTCHA",
            "parameters": {
               "history_size": 10
            }
         },
         "rules": [
            {
               "conditions": [
                  {
                     "key": "stored_results_count",
                     "operator": "EQ",
                     "value": 10
                  },
                  {
                     "key": "success_rate",
                     "operator": "LTE",
                     "value": 70.0
                  }
               ],
               "action": {
                  "type": "RESTRICTION_V2",
                  "parameters": {
                     "scope": "PROJECT",
                     "duration_unit": "DAYS",
                     "duration": 10,
                     "private_comment": "Incorrect captcha entered"
                  }
               }
            }
         ]
      }
   ]
}

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": "Incorrect captcha entered"
                  }
               }
   ...
}

Keys

Key

Value

Data type

Required during creation

captcha_frequency

The frequency of showing captchas:

  • LOW — Show one for every 20 tasks.

  • MEDIUM, HIGH — Show one for every 10 tasks.

By default, captchas aren't displayed.

String

No

collector_сonfig.parameters.history_size

The maximum number of recently displayed captchas in the project to use for the calculation.

If this field is omitted, the calculation is based on all the captchas shown for the pool.

Integer

Yes

rules.conditions.key

Parameters that are checked in the condition:

  • stored_results_count — The number of captcha attempts (less than or equal to history_size).

  • success_rate — The percentage of successful responses (from 0 to 100).

  • fail_rate — The percentage of unsuccessful responses (from 0 to 100).

String

Yes

Key

Value

Data type

Required during creation

captcha_frequency

The frequency of showing captchas:

  • LOW — Show one for every 20 tasks.

  • MEDIUM, HIGH — Show one for every 10 tasks.

By default, captchas aren't displayed.

String

No

collector_сonfig.parameters.history_size

The maximum number of recently displayed captchas in the project to use for the calculation.

If this field is omitted, the calculation is based on all the captchas shown for the pool.

Integer

Yes

rules.conditions.key

Parameters that are checked in the condition:

  • stored_results_count — The number of captcha attempts (less than or equal to history_size).

  • success_rate — The percentage of successful responses (from 0 to 100).

  • fail_rate — The percentage of unsuccessful responses (from 0 to 100).

String

Yes