Documentatie menu

RecaptchaV3TaskProxyless: solve Google Recaptcha v3

Dit soort taakobjecten is verplicht om Google Recaptcha V3 op de computer van een medewerker op te lossen. Deze taak wordt uitgevoerd door onze service door middel van onze eigen proxyservers en/of IP-adressen van de medewerkers.

Denk eraan dat er een verschil bestaat tussen Recaptcha V2-onzichtbaar en Recaptcha V3. Ze zien er hetzelfde uit en het kan verwarrend zijn. Er bestaat een snelle manier om het juiste type te bepalen: probeer het op te lossen met onze API als V2-onzichtbaar en V3. In een van de pogingen ontvangt u een fout, en in de ander ontvangt u die niet.

We testen onze medewerkers op hun recaptcha "score" en stoppen ze in 3 groepen (wachtrijen): 0.3, 0.7 en 0.9. Elke heeft wellicht iets andere prijzen door het aantal inactieve medewerkers. Door de eigenschap minScore door te geven bepaalt u de wachtrij waarin uw taak terecht zal komen. De meeste van onze beschikbare medewerkers hebben een score van 0.3, en de minste hebben 0.9.

Meer informatie over Recaptcha V3 kan worden gevonden in dit gedeelte van Veelgestelde Vragen.

Een voorbeeld van Recaptcha v3. Over het algemeen staat er een logo badge aan de rechteronderkant van de pagina. Het kan echter eenvoudig worden verwijderd met Javascript.

Taak object

Eigenschap Type Verplicht Doel
type String Ja RecaptchaV3TaskProxyless
websiteURL String Ja Adres van een doelpagina. Kan overal op de website geplaatst zijn, zelfs in een ledengedeelte. Onze medewerkers navigeren daar niet heen, simuleren in plaats daarvan het bezoek.
websiteKey String Ja Recaptcha website sleutel. Leer hoe u het vindt in dit artikel.
minScore Dubbel Ja Filtert een medewerker met een vereiste score. De waarde kan een van de volgende zijn:
0.3
0.7
0.9
pageAction String No
Recaptcha's "actie" waarde. De website eigenaar definieert wat de gebruiker doet op de pagina door middel van deze parameter.
Voorbeeld:

grecaptcha.execute('site_key', {action:'login_test'})
isEnterprise Booleaans No Stel deze vlag in op "waar" als u dit V3 opgelost moet hebben met Enterprise API. Standaardwaarde is "fout" en Recaptcha wordt opgelost met niet-enterprise API. Kan worden gepaald door een javascript oproep zoals in het volgende voorbeeld:

grecaptcha.enterprise.execute('site_key', {..})

Voorbeeld aanvraag

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"RecaptchaV3TaskProxyless",
            "websiteURL":"http://mywebsite.com/recaptcha/test.php",
            "websiteKey":"6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
            "minScore": 0.3,
            "pageAction": "myverify",
            "isEnterprise": false
        }
}' https://api.anti-captcha.com/createTask
        

Voorbeeld reactie

JSON zonder fouten
          {
    "errorId": 0,
    "taskId": 7654321
}
        
JSON met een fout
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

Haal de oplossing op

Gebruik methode getTaskResult om de oplossing aan te vragen. Geef een medewerker wat tijd, zoals 5 seconden, voordat u uw eerste aanvraag doet. Als de medewerkers nog steeds bezet is, probeert u het na 3 seconden.

Taak oplossing object

Eigenschap Type Doel
gRecaptchaResponse String Token string die vereist is voor het samenwerken met het ingediende formulier op een doelwebsite.

Voorbeeld reactie

JSON zonder fouten
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}