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.

In the example below, the user is blocked from accessing the project if 7 out of 10 captchas are entered incorrectly.

{
   "captcha_frequency":"LOW",
   "configs":[
      {
         "collector_сonfig":{
            "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",
                  "parameters":{
                     "scope":"PROJECT",
                     "private_comment":"Entered incorrect captcha.",
                     "duration_days":2
                  }
               }
            }
         ]
      }
   ]
}

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