Release CapMonster Cloud — New functionality

[ZennoLab Team]

Friends!

We would like to inform you about extremely important changes to the functionality of CapMonster Cloud when solving hCaptcha, which will affect many of our users.

The changes are relevant only for those who pass User Agent. For other users everything remains unchanged.

Benefits

The new functionality will allow you not to overpay for unaccepted tokens (due to an invalid User Agent) and improve token acceptance.

What's new?

+ We've added an additional parameter createTask: "fallbackToActualUA". This parameter can have 2 values:

• "fallbackToActualUA":true
  In this case, we ignore the invalid User Agent that users send in the request, and return our (valid) one with getTaskResult. This will improve the tokens acceptance.
  
• "fallbackToActualUA":false (or no parameter)
  In this case, we insert the User Agent that is specified in the request. If the User Agent is invalid, you will receive an error ERROR_WRONG_USERAGENT (USERAGENT IS EXPIRED in the log).

We strongly recommend adding "fallbackToActualUA":true or "fallbackToActualUA":false to the request, depending on your needs. This will allow you to get predictable results in all cases.

Request example

{
    "clientKey":"XXXX",
    "task":
    {
        "type":"HCaptchaTaskProxyless",
        "websiteURL":"https://lessons.zennolab.com/captchas/hcaptcha/?level=easy",
        "websiteKey":"472fc7af-86a4-4382-9a49-ca9090474471",
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36",
        "fallbackToActualUA":true
    }
}

The feature is already available for use.