GoLive Tech

Introdução

Serviço de resolução de CAPTCHAs com API. Resolva qualquer tipo de CAPTCHA de forma rápida e precisa.

Fornecemos uma API que permite automatizar o processo e integrar seu software ao nosso serviço. Existem alguns passos simples para resolver seu captcha ou reconhecer a imagem:

1 - Envie sua imagem ou captcha para nosso servidor.

2 - Obtenha o ID da sua tarefa.

3 - Inicie um ciclo que verifica se sua tarefa foi concluída.

4 - Obtenha o resultado.

Como Funciona

1

Enviar CAPTCHA

Envie seu CAPTCHA para nosso servidor via API

2

Receber ID

Servidor retorna ID da sua tarefa

3

Aguardar Resolução

Nossos workers resolvem o CAPTCHA

4

Obter Resultado

Consulte o resultado usando o ID

Como Começar

1. Obter Chave da API

Cada usuário recebe uma chave de autenticação única de 32 caracteres que se parece com:

1abc234de56fab7c89012d34e56fa7b8

2. URLs da API

Criar Tarefa:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

Consultar Resultado:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

3. Formato de Requisição

Atenção!

Nosso serviço recebe dados como multipart/form-data, mas sempre retorna JSON.

Autenticação

Todas as requisições devem incluir sua chave da API no parâmetro key.

Endpoints

POST /v001/task

Cria uma nova tarefa de resolução de CAPTCHA.

Sucesso

Retorna: {"request": "TASK_ID"}

GET /v001/res

Consulta o resultado de uma tarefa usando o ID.

Pronto

Retorna: TOKEN_SOLUTION *Verifique a seção específica do captcha para detalhes.

Processando

Retorna: CAPCHA_NOT_READY

Tarifas

Tipo de CaptchaPreço/1000 reqDescrição
Imagem de CaptchaR$ 3,32Captcha baseado em imagens com texto distorcido
Captcha de TextoR$ 3,32Captcha baseado em texto que requer resposta a uma pergunta
reCAPTCHA V2R$ 5,21reCAPTCHA V2 do Google resolvido via token
reCAPTCHA CallbackR$ 5,21reCAPTCHA com callback resolvido via token
reCAPTCHA V2 InvisibleR$ 5,21reCAPTCHA V2 Invisível resolvido via token
reCAPTCHA V3R$ 7,58reCAPTCHA V2 do Google resolvido via token
reCAPTCHA EnterpriseR$ 5,21reCAPTCHA Enterprise resolvido via token
Cloudflare TurnstileR$ 7,58Cloudflare Turnstile resolvido via token
Amazon WAFR$ 7,58Amazon WAF Captcha resolvido via token
GeeTestR$ 7,58GeeTest resolvido via token
GeeTest V4R$ 7,58GeeTest V4 resolvido via token
FunCaptchaR$ 473,68FunCaptcha resolvido via token
KeyCaptchaR$ 7,58Captcha no formato KeyCaptcha
GridR$ 11,37Captcha onde você precisa selecionar imagens em grade
CanvasR$ 11,37Captcha baseado em canvas
ClickCaptchaR$ 11,37Captcha onde é necessário clicar em pontos específicos
RotateCaptchaR$ 4,74Captcha onde é necessário rotacionar imagens
CaptchaFoxR$ 13,74CaptchaFox resolvido via token
Temu CaptchaR$ 9,47Temu Captcha resolvido via token
hCaptchaR$ 28,42hCaptcha de sistemas públicos resolvido via token

Resolvendo CAPTCHAs

O processo de resolução de captchas com o SolveCaptcha é muito fácil e é basicamente o mesmo para todos os tipos de captchas:

1. Obtenha sua chave de API na página de configurações da sua conta. Cada usuário recebe um token de autenticação exclusivo, que chamamos de chave de API. É uma string de 32 caracteres, semelhante a: 1abc234de56fab7c89012d34e56fa7b8. Essa chave será usada para todas as suas solicitações ao nosso servidor.

2. Envie uma solicitação HTTP Post para a URL da nossa API:https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/taskcom os parâmetros correspondentes ao tipo do seu captcha. O Servidor retornará o ID do captcha ou um código de erro se algo der errado.

3. Defina um tempo limite: 20 segundos para reCAPTCHA, 5 segundos para outros tipos de captchas.

4. Envie uma solicitação HTTP GET para a URL da nossa API:https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/respara obter o resultado.

Se o captcha já estiver resolvido, o servidor retornará a resposta no formato correspondente ao tipo do seu captcha.

As respostas são retornadas como JSON no formato{"status":1,"request":"TEXT"}.

Se o captcha ainda não estiver resolvido, o servidor retornará o resultadoCAPCHA_NOT_READY. Repita a solicitação após 5 segundos.

Se algo der errado, o servidor retornará um código de erro.

Captcha de Imagem

Captcha de Imagem é uma imagem que contém texto distorcido mas legível por humanos. Para resolver o captcha, o usuário deve digitar o texto da imagem.

Para resolver o captcha com nosso serviço, você deve enviar a imagem com uma requisição HTTP POST para nossa URL da API:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

O servidor aceita imagens em formato multipart ou base64.

SUA_CHAVE_API é a sua chave de API.

BASE64_FILE é o corpo da imagem codificado em base64.

Lista de Parâmetros POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

Parâmetro POSTTipoObrigatórioDescrição
keyStringSimSua chave de API.
methodStringSimbase64: Define que você está enviando uma imagem codificada em base64.
phraseIntegerNão (Padrão: 0)0: Captcha contém uma palavra.
1: Captcha contém duas ou mais palavras.
regsenseIntegerNão (Padrão: 0)0: Captcha não é sensível a maiúsculas/minúsculas.
1: Captcha é sensível a maiúsculas/minúsculas.
numericIntegerNão (Padrão: 0)0: Não especificado.
1: Captcha contém apenas números.
2: Captcha contém apenas letras.
3: Captcha contém apenas números OU apenas letras.
4: Captcha contém números E letras.
calcIntegerNão (Padrão: 0)0: Não especificado.
1: Captcha requer cálculo (ex: digite o resultado 4 + 8 = ).
min_lenIntegerNão (Padrão: 0)0: Não especificado.
1..20: Número mínimo de símbolos no captcha.
max_lenIntegerNão (Padrão: 0)0: Não especificado.
1..20: Número máximo de símbolos no captcha.
languageIntegerNão (Padrão: 0)0: Não especificado.
1: Captcha cirílico.
2: Captcha latino.
textinstructionsString (Máx 140 caracteres, UTF-8)NãoTexto será mostrado ao worker para ajudá-lo a resolver o captcha corretamente. Exemplo: digite apenas os símbolos vermelhos.
imginstructionsImagem (Máx 100x100px, 25 kB)NãoImagem será mostrada ao worker para ajudá-lo a resolver o captcha corretamente. O servidor aceita imagens de formulário multipart ou codificadas em base64.
header_acaoIntegerNão (Padrão: 0)0: Desabilitado.
1: Habilitado. Se habilitado, incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta. Usado para requisições AJAX cross-domain em aplicações web.
pingbackStringNãoURL para resposta de pingback (callback) que será enviada quando o captcha for resolvido. A URL deve estar registrada no servidor.

Você pode fornecer parâmetros adicionais com sua requisição para definir que tipo de captcha você está enviando e para ajudar os workers a resolver seu captcha corretamente.

Se tudo estiver correto, o servidor retornará o ID do seu captcha como JSON {"status":1,"request":"2122988149"}.

Se algo der errado, o servidor retornará um erro. Veja o capítulo Tratamento de Erros para a lista de erros.

Faça um timeout de 5 segundos e envie uma requisição HTTP GET para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res fornecendo o ID do captcha. A lista de parâmetros está na tabela abaixo.

Lista de Parâmetros GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API.
actionStringSimget: Para obter o resultado do captcha.
idStringSimID do captcha retornado pela requisição POST.

Exemplo de URL de solicitação:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

Captcha de Texto

O Captcha de Texto é um tipo de captcha representado como texto e não contém imagens. Normalmente, você precisa responder a uma pergunta para passar na verificação.

Por exemplo: "Se amanhã é sábado, que dia é hoje?".

Para resolver o captcha de texto com nosso serviço, você precisa enviar o texto como um valor do parâmetro textcaptcha com uma solicitação HTTP POST para nossa URL de API:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

SUA_CHAVE_API é a sua chave de API.

Você pode fornecer parâmetros adicionais com sua requisição para nos dar mais informações sobre seu captcha e para ajudar os trabalhadores a resolvê-lo corretamente. Você pode encontrar a lista completa de parâmetros na tabela abaixo.

Se tudo estiver correto, o servidor retornará o ID do seu captcha como JSON {"status":1,"request": "2122988149"}.

Se algo der errado, o servidor retornará um erro. Veja o capítulo Tratamento de Erros para a lista de erros.

Faça um timeout de 5 segundos e envie uma requisição GET para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res fornecendo o ID do captcha. A lista de parâmetros está na tabela abaixo.

Se tudo estiver correto e seu captcha for resolvido, o servidor retornará a resposta como JSON {"status":1,"request":"TEXT"}.

Caso contrário, o servidor retornará CAPCHA_NOT_READY que significa que seu captcha ainda não foi resolvido. Apenas repita sua requisição em 5 segundos.

Se algo der errado, o servidor retornará um erro. Veja o capítulo Tratamento de Erros para a lista de erros.

Lista de parâmetros de requisição POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

Parâmetro POSTTipoObrigatórioDescrição
keyStringSimSua chave de API
languageIntegerNão0 - não especificado
1 - Captcha cirílico (russo)
2 - Captcha latino
Padrão: 0
textcaptchaStringSimTexto será mostrado ao worker para ajudá-lo a resolver o captcha corretamente.
Por exemplo: digite apenas os símbolos vermelhos.
Máximo: 140 caracteres, Codificação: UTF-8
header_acaoIntegerNão0 - desabilitado
1 - habilitado.
Se habilitado, 'in.php' incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta.
Usado para requisições AJAX cross-domain em aplicações web.
Padrão: 0
pingbackStringNãoURL para resposta de pingback (callback) que será enviada quando o captcha for resolvido.
A URL deve estar registrada no servidor. Mais informações aqui.

Lista de parâmetros de requisição GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimO valor para este parâmetro deve ser get, indicando a ação para obter a resposta do seu captcha.
idIntegerSimID do captcha retornado por in.php.
header_acaoIntegerNão0 - desabilitado
1 - habilitado. Se habilitado, res.php incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta.
Usado para requisições AJAX cross-domain em aplicações web.
Padrão: 0

Exemplo de URL de solicitação:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

reCAPTCHA V2

reCAPTCHA V2 também conhecido como "I'm not a robot" reCAPTCHA é um tipo muito popular de captcha que se parece com isso:

reCAPTCHA V2 Example

Resolver reCAPTCHA V2 com nosso novo método é bem simples:

• Olhe o código do elemento na página onde você encontrou o reCAPTCHA.

Como inspecionar elemento reCAPTCHA

• Encontre um link que comece com www.google.com/recaptcha/api2/anchor ou encontre o parâmetro data-sitekey.

• Copie o valor do parâmetro k do link (ou o valor do parâmetro data-sitekey).

Como inspecionar elemento reCAPTCHA

• Envie uma solicitação HTTP GET ou POST para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task com o método definido como userrecaptcha e informe o valor encontrado na etapa anterior como valor para googlekey e a URL completa da página como valor para pageurl.

Exemplo de URL de solicitação:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task?key=1abc234de56fab7c89012d34e56fa7b8&method=userrecaptcha&googlekey=6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-&pageurl=http://mysite.com/page/with/recaptcha?appear=1&here=now

• Se tudo estiver correto, o servidor retornará o ID do seu captcha como JSON {"status":1,"request":"2122988149"}.

• Defina um tempo limite de 15 a 20 segundos e envie uma solicitação HTTP GET para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

Respostas do Servidor

Se o captcha já foi resolvido, o servidor responderá com um token de resposta no formato:

{"status":1,"request":"YOUR_TOKEN"}

Se ainda não resolvido: CAPCHA_NOT_READY. Repita em 5s.

Se erro: um código de erro será retornado.

  • • Localize o elemento g-recaptcha-response e torne-o visível removendo display:none.
g-recaptcha-response

Às vezes o conteúdo é gerado via JavaScript; use Inspecionar para ver o DOM dinâmico.

Você pode definir o valor via JavaScript:

document.getElementById("g-recaptcha-response").innerHTML="TOKEN_FROM_SOLVECAPTCHA";
  • • Cole o token e envie o formulário.
answer
  • • Depois de enviar, sucesso.
hooray

reCAPTCHA Callback

Alguns sites usam callback ao resolver.

Método 1: parâmetro data-callback.

data-callback="myCallbackFunction"

Método 2: parâmetro callback em grecaptcha.render.

grecaptcha.render('example', {
  'sitekey': 'someSitekey',
  'callback' : myCallbackFunction,
  'theme': 'dark'
});

Encontrando o callback

__grecaptcha_cfg.clients[0].aa.l.callback

Pode variar por cliente.

Chamando o callback

myCallbackFunction();
__grecaptcha_cfg.clients[0].aa.l.callback();
myCallbackFunction('TOKEN');

reCAPTCHA Callback

Alguns sites usam callback ao resolver.

Método 1: parâmetro data-callback.

data-callback="myCallbackFunction"

Método 2: parâmetro callback em grecaptcha.render.

grecaptcha.render('example', {
  'sitekey': 'someSitekey',
  'callback' : myCallbackFunction,
  'theme': 'dark'
});

Encontrando o callback

__grecaptcha_cfg.clients[0].aa.l.callback

Pode variar por cliente.

Chamando o callback

myCallbackFunction();
__grecaptcha_cfg.clients[0].aa.l.callback();
myCallbackFunction('TOKEN');

reCAPTCHA V2 Invisível

Versão invisível disponível.

Demo: link

Use o parâmetro invisible=1.

O reCAPTCHA invisível está localizado em uma camada DIV posicionada a -10.000 px do topo, o que o torna invisível para o usuário.

O reCAPTCHA pode ser acionado no carregamento da página ou em ações do usuário como clicar ou enviar um formulário — depende do site. Se os cookies do usuário forem bons, ele pode passar automaticamente; caso contrário, verá o desafio padrão do reCAPTCHA.

Na maioria dos casos, quando o desafio é concluído, uma função de callback é executada (veja a seção de Callback acima).

Se ainda tiver dúvida, há algumas formas de identificar o modo invisível:

  • Você não vê a caixa "Não sou um robô" na página, mas recebe um desafio ao realizar alguma ação.
  • O link do iframe do reCAPTCHA contém o parâmetro size=invisible.
  • O objeto de configuração do reCAPTCHA possui size definido como invisible, por exemplo: __grecaptcha_cfg.clients[0].aa.l.size = "invisible".

Como passar pelo reCAPTCHA invisível no navegador?

Método 1: usando JavaScript

  • Altere o valor do elemento g-recaptcha-response para o token de resposta que você recebeu do nosso servidor:
    document.getElementById("g-recaptcha-response").innerHTML="TOKEN_FROM_SOLVECAPTCHA";
  • Execute a ação necessária na página após resolver o reCAPTCHA. Geralmente é enviar um formulário. Identifique o formulário por id, name ou classe e chame submit():
    document.getElementById("recaptcha-demo-form").submit();   // por id
document.getElementsByName("myFormName")[0].submit();     // por name
document.getElementsByClassName("example")[0].submit();   // por class

Em muitos sites há uma função de callback executada quando o reCAPTCHA é resolvido. Ela costuma estar no atributo data-callback do elemento, por exemplo:

data-callback="myCallbackFunction"

Ou definida como parâmetro callback em grecaptcha.render:

grecaptcha.render('example', {
  'sitekey' : 'someSitekey',
  'callback' : myCallbackFunction,
  'theme' : 'dark'
});

Basta chamar a função:

myCallbackFunction();
  • Pronto! Você fez isso com apenas 2 linhas.

Método 2: alterando o HTML

  • Corte a DIV que contém o reCAPTCHA do corpo da página. Exemplo típico (resumido):
    <div style="visibility: hidden; position: absolute; width:100%; top: -10000px; left: 0; right: 0;">
  <div style="width: 100%; height: 100%; position: fixed; top: 0; left: 0; z-index: 2000000000;"></div>
  <div style="margin: 0 auto; top: 0; left: 0; right: 0; position: absolute; border: 1px solid #ccc;">
    <iframe src="https://www.google.com/recaptcha/api2/bframe?..." />
  </div>
</div>
  • Ou remova todo o bloco de implementação do reCAPTCHA (exemplo):
    <div class="">
  <!-- BEGIN: ReCAPTCHA implementation example. -->
  <div id="recaptcha-demo" class="g-recaptcha" data-sitekey="6LfPC..." data-callback="onSuccess"></div>
  <script>
    var onSuccess = function(response) {
      var errorDivs = document.getElementsByClassName("recaptcha-error");
      if (errorDivs.length) { errorDivs[0].className = ""; }
      var errorMsgs = document.getElementsByClassName("recaptcha-error-message");
      if (errorMsgs.length) { errorMsgs[0].parentNode.removeChild(errorMsgs[0]); }
      document.getElementById("recaptcha-demo-form").submit();
    };
  </script>
  <!-- END: ReCAPTCHA implementation example. -->
</div>

Coloque o seguinte código no lugar do bloco que você removeu:

<input type="submit">
<textarea name="g-recaptcha-response">%g-recaptcha-response%</textarea>

Onde %g-recaptcha-response% é o token de resposta recebido do nosso serviço.

  • Você verá um botão “Submit query”.
  • Pressione o botão para enviar o formulário com o g-recaptcha-response e os demais dados.

Parâmetros de requisição (GET/POST) para: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimuserrecaptcha — define que você está enviando um reCAPTCHA v2 com o novo método.
googlekeyStringSimValor do parâmetro k do link ou data-sitekey encontrado na página.
pageurlStringSimURL completa da página onde você vê o reCAPTCHA.
invisibleIntegerNão1 — reCAPTCHA invisível; 0 — reCAPTCHA normal. Padrão: 0
header_acaoIntegerNão0 — desabilitado; 1 — habilitado. Inclui o cabeçalho Access-Control-Allow-Origin:* na resposta. Útil para AJAX cross-domain.
pingbackStringNãoURL para callback que será chamada quando o captcha for resolvido (deve estar registrada no servidor).
proxyStringNãoFormato: login:password@123.123.123.123:3128. Mais sobre proxies na documentação.
proxytypeStringNãoTipo do proxy: HTTP, HTTPS, SOCKS4, SOCKS5.

Lista de parâmetros de requisição GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimget — obter a resposta do seu captcha.
idIntegerSimID do captcha retornado ao criar a tarefa.

Exemplo de URL da requisição:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

reCAPTCHA V3

reCAPTCHA V3 é uma versão moderna do CAPTCHA do Google que avalia a "humanidade" do usuário com base em seu comportamento e não requer nenhuma ação do usuário.

A nova versão do reCAPTCHA mantém muitas semelhanças com o reCAPTCHA V2, pois seu mecanismo central permanece inalterado. O usuário recebe um token da API do reCAPTCHA, que é então enviado em uma solicitação POST para o servidor do site. O servidor então verifica a validade do token usando a API do reCAPTCHA.

No entanto, durante a verificação do token, a API do reCAPTCHA agora retorna uma pontuação numérica de "humanidade", variando de 0.1 a 0.9. Com base nesta pontuação, o site decide independentemente como proceder com o processamento da solicitação.

Além disso, um novo parâmetro chamado action foi introduzido, permitindo que diferentes ações do usuário no site sejam processadas de forma diferente. Durante a verificação do token, a API do reCAPTCHA retorna o nome da ação realizada pelo usuário.

Instruções para resolver reCAPTCHA V3 usando nosso serviço:

1. Antes de começar a trabalhar com reCAPTCHA V3, certifique-se de que o site usa esta versão específica. Isso pode ser identificado pelos seguintes sinais:

1. Invisibilidade para o usuário. O reCAPTCHA V3 é completamente oculto do usuário e não requer tarefas como selecionar imagens ou clicar em elementos.

2. O código-fonte do site inclui o script da API do reCAPTCHA com um parâmetro render especificando a chave pública do site (sitekey).

Exemplo: <script src="https://www.google.com/recaptcha/api.js?render=6LfZiI0UAAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE"></script>

3. No objeto de configuração __grecaptcha_cfg, o array clients usa um elemento com o índice 100000, que pode ser acessado via __grecaptcha_cfg.clients[100000].

2. Para contornar o reCAPTCHA V3 usando nossa API, você precisa definir os valores para dois parâmetros obrigatórios:

pageurl - Especifique a URL completa da página onde o reCAPTCHA V3 precisa ser resolvido.

sitekey - Pode ser encontrado no código HTML dentro do parâmetro render ao carregar o arquivo api.js, no parâmetro k dentro da URL do iframe que carrega o reCAPTCHA, no código JavaScript via a função grecaptcha.execute, ou no objeto de configuração __grecaptcha_cfg.

3. Após obter todos os parâmetros necessários, você pode enviar uma solicitação para nossa API.

4. Envie uma solicitação HTTP POST para nossa API:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

com sua chave de API pessoal e o parâmetro method correspondente ao seu tipo de CAPTCHA, neste caso — userrecaptcha. Além disso, forneça o valor que você copiou anteriormente no parâmetro googlekey. Especifique a URL completa da página onde você deseja resolver o reCAPTCHA no parâmetro pageurl.

Uma lista completa de parâmetros para a solicitação pode ser encontrada na tabela abaixo.

A lista completa de parâmetros para a solicitação pode ser encontrada na tabela abaixo.

Exemplos de código para enviar reCAPTCHA V3 usando cURL, Python, JavaScript, e Go são descritos abaixo.

5. Se você enviou uma solicitação válida, o servidor retornará o ID do seu CAPTCHA em formato JSON:

{"status":1,"request":"2122988149"}

6. Aguarde 15-20 segundos e envie uma solicitação HTTP GET para nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para recuperar o resultado.

A lista completa de parâmetros para a solicitação pode ser encontrada na tabela abaixo.

Se o seu CAPTCHA já foi resolvido, o servidor retornará uma resposta como texto simples ou JSON. A resposta contém o token. Um exemplo de uma resposta JSON:

{
  "status": 1,
  "request": "03AFcWeA5dCJ-20Qqwd0-2IHmBX3ItB176Z4WGMT-3WxkoYqSKrpU48GZhe4jRk1un_TyFoZ6aYI1Pn1J9w6HnPjgRdjWGOD"
}

Se o seu CAPTCHA ainda não foi resolvido, o servidor retornará o código CAPCHA_NOT_READY. Neste caso, repita sua solicitação após 5 segundos.

Exemplo de uma URL de solicitação:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&json=1&id=248734

7. Use o token recebido na página de destino.

A melhor maneira de entender como fazer isso é observar as solicitações enviadas ao site quando você interage com ele como um visitante regular. A maioria dos navegadores facilita isso usando o console do desenvolvedor, normalmente na aba "Network".

O token geralmente é enviado nos parâmetros de uma solicitação POST. Pode ser g-recaptcha-response como no reCAPTCHA V2,g-recaptcha-response-100000, ou outro parâmetro. Portanto, revise cuidadosamente os parâmetros da solicitação para identificar como o token é transmitido e, em seguida, construa uma solicitação semelhante.

8. Depois de usar o token no site e determinar se funcionou ou não, você pode nos informar sobre isso. Isso nos ajuda a coletar e analisar estatísticas para este tipo de CAPTCHA para otimizar ainda mais nossos algoritmos de resolução.

Mais detalhes sobre o envio de relatórios podem ser encontrados na seção response report.

Lista de parâmetros para solicitações POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimsua chave de API
methodStringSimuserrecaptcha — define que você está enviando um reCAPTCHA
versionStringSimv3 — define que você está enviando um reCAPTCHA V3
googlekeyStringSimValor do parâmetro sitekey que você encontrou na página
pageurlStringSimURL completa da página onde você vê o reCAPTCHA
header_acaoInteger
Padrão: 0		Não0 — desabilitado
1 — habilitado.
Se habilitado in.php incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta. Usado para solicitações AJAX de domínio cruzado em aplicações web. Também suportado por res.php.
pingbackStringNãoURL para pingback (callback) que será enviada quando o captcha for resolvido. A URL deve estar registrada no servidor. Mais informações aqui.

Lista de parâmetros de solicitação GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

ParâmetroTipoObrigatórioDescrição
keyStringSimsua chave de API
actionStringSimget — obter a resposta do seu captcha
idIntegerSimID do captcha retornado por in.php.
header_acaoInteger
Padrão: 0		Não0 — desabilitado
1 — habilitado.
Se habilitado res.php incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta. Usado para solicitações AJAX de domínio cruzado em aplicações web.

reCAPTCHA Enterprise

reCAPTCHA Enterprise é o tipo mais recente de CAPTCHA do Google, combinando as capacidades do V2 e V3. Ele também permite que os administradores do site informem ao Google se acreditam que o usuário que interage com o site após resolver o CAPTCHA é um bot ou um humano.

Como Usar Nosso Serviço para Resolver reCAPTCHA Enterprise

1. Inspecione o site e procure por data-sitekey (V2) ou grecaptcha.enterprise.execute (V3) e copie uma string que se pareça com esta: 6Lel38UnAAAAAMRwKj9qLH2Ws4Tf2uTDQCyfgR6b. Esta será a sua googlekey. Dependendo da configuração do CAPTCHA no site, pode incluir um parâmetro action, semelhante ao V3, e também pode exigir um min_score.

2. Envie uma solicitação POST para nossa API conforme o código ao lado para a URL:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

3. Recupere o ID do CAPTCHA criado.

4. Solicite o resultado da solução de https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Exemplo de URL de solicitação:
https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&json=1&id=2122988149

5. Use o token recebido no site. O método de aplicação do token depende do recurso web específico e das solicitações que ele executa. Não há um algoritmo universal para isso.

Lista de Parâmetros de Solicitação GET/POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task
Parâmetro POSTTipoObrigatórioDescrição
keyStringSimsua chave de API
methodStringSimuserrecaptcha — especifica que você está resolvendo um reCAPTCHA
googlekeyStringSimO valor do parâmetro sitekey que você encontrou no código do site
pageurlStringSimA URL completa da página onde você está resolvendo o reCAPTCHA
enterpriseNumber
Padrão: 1		Sim1 — indica que este é reCAPTCHA Enterprise
versionStringNãoversão do reCAPTCHA:
v2 — indica que este é reCAPTCHA V2
v3 — indica que este é reCAPTCHA V3
Padrão: v2
domainString
Padrão: google.com		NãoO domínio usado para carregar reCAPTCHA, que pode ser recaptcha.net ou google.com
invisibleNumber
Padrão: 0		Não1 — indica que o site usa um reCAPTCHA invisível.
0 — reCAPTCHA regular
actionString
Padrão: verify		NãoO valor do parâmetro action que você encontrou no código do site
min_scoreNumber
Padrão: 0.4		NãoValor de pontuação necessário. A faixa recomendada é de 0.3 a 0.9
data-sStringNãoO parâmetro data-s encontrado na página representa um valor usado para processar solicitações no mecanismo de busca do Google e outros serviços da empresa.
cookiesStringNãoSeus cookies que serão usados pelo worker para resolver o CAPTCHA. Na resposta do CAPTCHA, retornaremos os cookies do worker, mas somente ao usar o formato json=1. Formato: KEY:value separador: ponto e vírgula, por exemplo: 'KEY1:value1;KEY2:value2;'. Você pode usar um método de envio de cookies estendido, que é descrito em detalhes na seção cookies.
userAgentStringNãoDefine seu userAgent para o worker
proxyStringNãoFormato: username:password@123.123.123.123:3128
Mais informações sobre proxies podem ser encontradas aqui
proxytypeStringNãoTipo do seu servidor proxy: HTTP, HTTPS, SOCKS4, SOCKS5
header_acaoNumber
Padrão: 0		Não0 — desabilitado
1 — habilitado.
Se habilitado in.php incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta. Usado para solicitações AJAX de domínio cruzado em aplicações web.
Lista de Parâmetros de Solicitação GET/POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res
Parâmetro GETTipoObrigatórioDescrição
keyStringSimsua chave de API
actionStringSimget — recuperar a resposta do CAPTCHA
idNumberSimO ID do CAPTCHA recebido de in.php.
header_acaoNumber
Padrão: 0		Não0 — desabilitado
1 — habilitado.
Se habilitado, in.php incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta. Usado para solicitações AJAX de domínio cruzado em aplicações web.

Cloudflare Turnstile

Cloudflare Turnstile é um sistema CAPTCHA desenvolvido pela Cloudflare projetado para proteger formulários web e páginas de envios automatizados ou atividade maliciosa.

Para resolver o Turnstile Captcha você precisa:

1. Inspecionar o site em questão
2. Procurar pelo atributo data-sitekey e copiar seu valor.
3. Usar o valor copiado como o parâmetro sitekey ao enviar o CAPTCHA Turnstile para nossa API.

Exemplo de Resposta POST

{
  "status": 1,
  "request": "74327409378"
}

Exemplo de Resposta GET

{"status":1,"request":"XXXX.DUMMY.TOKEN.XXXX","useragent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36"}

Parâmetros da Requisição POST

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimturnstile - define o tipo de CAPTCHA que você está enviando
sitekeyStringSimA chave do site Turnstile obtida ao inspecionar o site alvo
pageurlStringSimA URL da página onde o CAPTCHA Turnstile está localizado

Parâmetros da Requisição GET

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimget - define que você está solicitando o resultado
idStringSimID da tarefa retornado pela solicitação anterior

Amazon Captcha

"Amazon captcha, também conhecido como AWS WAF captcha, é um componente do sistema fornecido pela Amazon AWS."

Para contornar o captcha, você precisa coletar os seguintes parâmetros da página desafiada:

  • sitekey - valor do parâmetro sitekey no código-fonte da página
  • iv - valor do parâmetro iv no código-fonte da página
  • context - valor do parâmetro context no código-fonte da página
  • pageurl - a URL completa da página onde o desafio CAPTCHA foi apresentado

Exemplo de Requisição POST https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

{
  "key": "YOUR_API_KEY",
  "method": "amazon_waf",
  "sitekey": "XXXXX",
  "iv": "XXXXX",
  "context": "XXXXX",
  "pageurl": "https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest"
}

Se a requisição for bem-sucedida, a resposta será assim:

{
  "status": 1,
  "request": "XXXXX"
}

Se a requisição falhar, um código de erro será retornado.

Recuperando o Resultado

Aguarde 15-20 segundos, então envie uma requisição de acordo com os exemplos ao lado GET https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Resposta do CAPTCHA Resolvido

Se o CAPTCHA foi resolvido:

{
  "status": 1,
  "request": {
    "captcha_voucher": "XXXXX",
    "existing_token": "XXXXX"
  }
}

CAPTCHA Não Pronto

Se o CAPTCHA ainda está sendo resolvido:

{
  "status": 0,
  "request": "CAPCHA_NOT_READY"
}

Tente novamente em 5 segundos.

Tratamento de Erros

Em caso de erro, o servidor retornará um código de erro. Consulte a lista de erros para mais detalhes.

Lista de parâmetros de requisição POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimDeve ser amazon_waf
sitekeyStringSimValor de key da página CAPTCHA
ivStringSimValor de iv da página CAPTCHA
contextStringSimValor de context da página CAPTCHA
pageurlStringSimURL completa da página onde o CAPTCHA aparece
challenge_scriptStringNãoURL completa para challenge.js
captcha_scriptStringNãoURL completa para captcha.js
header_acaoIntegerNão
1 para incluir cabeçalhos CORS na resposta
Padrão: 0
pingbackStringNãoURL de pingback opcional para receber um callback após a resolução
proxyStringNãoFormato: login:senha@host:porta
proxytypeStringNãoUm de: HTTP, HTTPS, SOCKS4, SOCKS5

Lista de parâmetros de solicitação GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimDeve ser get
idIntegerSimID do CAPTCHA recebido da resposta da solicitação de tarefa

Geetest

Geetest é um tipo de captcha onde você precisa mover uma peça de um quebra-cabeça ou selecionar algumas figuras em ordem.

Instruções para resolver o captcha Geetest com o serviço:

1. Encontre os seguintes parâmetros do captcha Geetest no site de destino (geralmente você pode encontrá-los dentro da função initGeetest):
  • gt - chave pública do site (estática)
  • challenge - chave de desafio dinâmica
  • api_server - domínio da API (opcional)

Importante: você deve obter um novo valor de challenge para cada solicitação à nossa API. Uma vez que o captcha foi carregado na página, o valor do challenge se torna inválido. Você deve inspecionar as solicitações feitas ao site quando a página é carregada para identificar uma solicitação que obtém um novo valor de challenge. Então você deve fazer tal solicitação cada vez para obter um valor de challenge válido.

2. Envie uma solicitação HTTP POST para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task conforme os exemplos ao lado (Selecione sua linguagem).

Resposta da Solicitação Inicial (ID da Tarefa)

Se tudo estiver correto, o servidor retornará o ID da sua tarefa como JSON:

{
  "status": 1,
  "request": "2122988149"
}

Recuperando o Resultado do CAPTCHA

Aguarde de 15 a 20 segundos e, em seguida, envie uma solicitação HTTP GET para a nossa API para obter o resultado:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=YOUR_API_KEY&action=get&id=2122988149

Se o CAPTCHA já foi resolvido, o servidor retornará a resposta em JSON. A resposta contém três valores: geetest_challenge, geetest_validate e geetest_seccode:

{
  "status": 1,
  "request": {
    "geetest_challenge": "6983fe8d9b791f70ed9d6aa09a0aa3587t",
    "geetest_validate": "40cfb50a44cead6fc8464858a805b1b3",
    "geetest_seccode": "40cfb50a44cead6fc8464858a805b1b3|jordan"
  }
}

CAPTCHA Não Pronto

Se o CAPTCHA ainda não foi resolvido, o servidor retornará:

CAPCHA_NOT_READY

Repita sua solicitação em 5 segundos.

Tratamento de Erros

Se algo deu errado, o servidor retornará um código de erro.

Usando os Valores Resolvidos

Use os valores recebidos da nossa API para enviar sua solicitação ao site de destino, colocando os valores nos campos de solicitação correspondentes:

  • geetest_challenge
  • geetest_validate
  • geetest_seccode

Lista de parâmetros de solicitação GET/POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimgeetest - define que você está enviando um captcha Geetest
gtStringSimValor do parâmetro gt que você encontrou no site de destino
challengeStringSimValor do parâmetro challenge que você encontrou no site de destino
pageurlStringSimURL completa da página onde você vê o captcha Geetest
api_serverStringNãoValor do parâmetro api_server que você encontrou no site de destino
offlineNumberNão
Defina como 1 se offline: true for usado em initGeetest
Padrão: 0
new_captchaNumberNão
Defina como 1 se new_captcha: true for usado em initGeetest
Padrão: 0
header_acaoIntegerNão
Defina como 1 para incluir cabeçalho Access-Control-Allow-Origin:*
Padrão: 0
pingbackStringNãoURL para resposta de pingback (callback)
proxyStringNãoFormato do proxy: login:senha@123.123.123.123:3128
proxytypeStringNãoTipo do seu proxy: HTTP, HTTPS, SOCKS4, SOCKS5
userAgentStringNãoSeu userAgent usado para resolver o captcha

Lista de parâmetros de solicitação GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimget - obter a resposta para seu captcha
idIntegerSimID do captcha retornado por task

Exemplo de URL de Solicitação

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

Geetest v4 Captcha

Geetest v4 é uma nova versão do desafio de quebra-cabeça, mas você ainda precisa mover uma peça do quebra-cabeça para contorná-lo.

Para resolver o captcha Geetest v4 com nosso serviço você precisa:

1. Encontre o valor captcha_id no código-fonte HTML da página. Normalmente, você encontrará o valor dentro de uma tag script que inclui o código JavaScript do Geetest v4 na página.
2. Envie uma solicitação HTTP GET ou POST para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task com o método definido como geetest_v4, fornecendo o captcha_id encontrado na página e a URL completa da página como valor para pageurl.

3. Se tudo estiver correto, o servidor retornará o ID do seu captcha como JSON: {"status":1,"request": "2122988149"}. Caso contrário, o servidor retornará um código de erro.

4. Faça um timeout de 15-20 segundos, então envie uma solicitação HTTP GET para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

Exemplo de Resposta de Sucesso

{
  "status": 1,
  "request": {
      "captcha_id": "e391447fd421dc634644d5a2ee9c73",
      "lot_number": "4ba5ab728db764e2a46qe083d4d663gd3f",
      "pass_token": "f29234g3e8f3ad20f12cd0d5ece03g3g6hd9424e9e6704e7h814c8de8j84r4",
      "gen_time": "1838256089",
      "captcha_output": "Sf3_je5GyO2g4V8m431BLIM4F5uK2webJdbXSntSbtTKUry4r6hGVQ3I2YzRBgBkGi4oJ9Xwu9w6WWKeY4mi1Oxc8qZxMlwJVvsVF2YZG2taOYHNA5UyOK6fk32sGRdq8gmypf-Fl9XOsvhtnGUi9xxN4CW7lj2VLMSdF_659SuVtfHtzdc3CcGSn1Z1k0SrtOsXZ_i7t9EEDciH-rcgTZz6hI-EFEbajage3Nbv0-33sODjdbk6MwmExDEGcm8hhQNYKQbbgF8rCNlxjk9wwkx63Up3s3-R8uDmcLHTM3BwW2SbccZzGjZW8rrPoC41qMNxPExMxipPldr0AQ7Z0-LTk61HmXZTmhYN9tbYwksfbgvck9l9bnhg5ddO7j8lKwYZbO1Hzjs85g6g7T053fyZe05WmClzNZ9F8g_sgMT2XTrhJXu_h67d4"
  }
}

Se o captcha ainda não foi resolvido, o servidor retornará CAPTCHA_NOT_READY. A solicitação deve ser repetida em 5 segundos.

Se algo deu errado, o servidor retornará um código de erro.

5. Use os valores recebidos de nossa API para enviar sua solicitação ao site de destino da mesma forma que é feito quando você contorna o captcha manualmente.

Lista de parâmetros de solicitação POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API.
methodStringSimgeetest_v4 - define que você está enviando o captcha Geetest v4.
captcha_idStringSimValor do parâmetro captcha_id que você encontrou no site de destino.
pageurlStringSimURL completa da página onde você vê o captcha Geetest.
header_acaoInteger (Padrão: 0)Não0 - desabilitado, 1 - habilitado. Se habilitado, task incluirá o cabeçalho Access-Control-Allow-Origin: * na resposta.
pingbackStringNãoURL para resposta de pingback (callback).
proxyStringNãoFormato do proxy: login:password@123.123.123.123:3128. Você pode encontrar mais informações sobre proxies aqui.
proxytypeStringNãoTipo do seu proxy: HTTP, HTTPS, SOCKS4, SOCKS5.

Lista de parâmetros de solicitação GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API.
actionStringSimget - obter a resposta para seu captcha.
idIntegerSimID do captcha retornado por task.

Exemplo de URL de Solicitação:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

Exemplos de Código para Enviar Captcha Geetest V4

FunCaptcha

"Agora fornecemos um método para resolver FunCaptcha com um token."

O método é bastante simples:

Você precisa localizar a chave pública do FunCaptcha. Existem duas maneiras de encontrá-la: você pode localizar o elemento div do funcaptcha e verificar o valor do parâmetro data-pkey ou você pode encontrar o elemento de entrada com o nome fc-token e então extrair a chave indicada após pk do valor deste elemento.

Envie uma solicitação HTTP GET ou POST para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task com o método definido como funcaptcha e forneça o valor encontrado na etapa anterior como valor para publickey e a URL completa da página como valor para pageurl. Enviar proxies não é obrigatório no momento, mas é recomendado.

Você pode encontrar a lista completa de parâmetros na tabela abaixo.

Exemplo de URL de Solicitação:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task?key=1abc234de56fab7c89012d34e56fa7b8&method=funcaptcha&publickey=12AB34CD

Se tudo estiver correto, o servidor retornará o ID do seu captcha como JSON: {"status":1, "request": "2122988149"}.

Caso contrário, o servidor retornará um código de erro.

Faça um timeout de 10-20 segundos, então envie uma solicitação HTTP GET para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

A lista completa de parâmetros está na tabela abaixo

Se o captcha já foi resolvido, o servidor responderá em texto simples ou JSON e retornará o token de resposta que se parece com:

30a4f4a302b176cd7.96368658|r=ap-southeast-1|guitextcolor=%237D5D3|metabgclr=%23FFFFFF|metaiconclr=%23757575|mainbgclr=%23FFFFFF

Se o captcha ainda não foi resolvido, o servidor retornará CAPCHA_NOT_READY result. Repita sua solicitação após 5 segundos.

Lista de parâmetros de solicitação POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimfuncaptcha - define que você está enviando um captcha FunCaptcha
publickeyStringSimValor da chave pública do FunCaptcha que você encontrou no site de destino
pageurlStringSimURL completa da página onde você vê o captcha FunCaptcha
surlStringNãoURL do serviço FunCaptcha. Pode ser necessário em alguns casos
dataStringNãoDados adicionais que podem ser necessários para resolver o captcha
header_acaoIntegerNão
Defina como 1 para incluir cabeçalho Access-Control-Allow-Origin:*
Padrão: 0
pingbackStringNãoURL para resposta de pingback (callback)
proxyStringNãoFormato do proxy: login:senha@123.123.123.123:3128
proxytypeStringNãoTipo do seu proxy: HTTP, HTTPS, SOCKS4, SOCKS5
userAgentStringNãoSeu userAgent usado para resolver o captcha

Lista de parâmetros de solicitação GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimget - obter a resposta para seu captcha
idIntegerSimID do captcha retornado por task

Exemplo de URL de Solicitação

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

KeyCaptcha

KeyCaptcha é um tipo de captcha onde você precisa resolver um quebra-cabeça simples.

Para resolver o captcha KeyCaptcha com nosso serviço você precisa:

1. Encontre os seguintes parâmetros no código-fonte da página:
  • s_s_c_user_id
  • s_s_c_session_id
  • s_s_c_web_server_sign
  • s_s_c_web_server_sign2
2. Envie uma solicitação HTTP POST para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task com o método definido como keycaptcha, fornecendo os valores encontrados na etapa anterior como parâmetros de solicitação correspondentes e também a URL completa da página como valor para pageurl.

Você pode encontrar a lista completa de parâmetros na tabela abaixo.

Exemplo de URL de Solicitação

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task?key=1abc234de56fab7c89012d34e56fa7b8&method=keycaptcha&s_s_c_user_id=10&s_s_c_session_id=49

3. Se tudo estiver correto, o servidor retornará o ID do seu captcha como JSON: {"status":1,"request": "2122988149"}. Caso contrário, o servidor retornará um código de erro.

4. Faça um timeout de 15-20 segundos, então envie uma solicitação HTTP GET para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

5. Se o captcha já foi resolvido, o servidor responderá em texto simples ou JSON e retornará a resposta que se parece com:

ebdb5a6bf76da6887db60ef2041ab946|9006dc725760858e4c0715b835472f22|http://back10.keycaptcha.com/swfs/ckc/5bded8

Se o captcha ainda não foi resolvido, o servidor retornará CAPTCHA_NOT_READY. Repita sua solicitação após 5 segundos.

6. Para usar a resposta do KeyCaptcha, você precisa fazer o seguinte:

a) Localize e delete o seguinte bloco que inclui o arquivo JavaScript do KeyCaptcha:

<script language="JavaScript" src="http://backs.keycaptcha.com/swfs/cap.js"></script>

b) Localize e delete a div com id="div_for_keycaptcha":

<div id="div_for_keycaptcha">....</div>

Nota importante: Às vezes o conteúdo na página é gerado dinamicamente e você não verá esses elementos no código-fonte HTML ou eles podem diferir um pouco. Nesses casos, você deve explorar o código-fonte da página e o código JavaScript que gera o conteúdo. A opção "Inspecionar" no Google Chrome pode ajudar nisso.

c) Localize o elemento com id="capcode" e altere seu valor para a resposta recebida do nosso servidor:

<input name="capcode" id="capcode" value="1|2|3|4|5" type="hidden">

d) Clique no botão de envio.

e) Parabéns, você passou no KeyCaptcha!

Lista de parâmetros de solicitação POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimkeycaptcha - define que você está enviando um captcha KeyCaptcha
s_s_c_user_idStringSimValor do parâmetro s_s_c_user_id que você encontrou no site de destino
s_s_c_session_idStringSimValor do parâmetro s_s_c_session_id que você encontrou no site de destino
s_s_c_web_server_signStringSimValor do parâmetro s_s_c_web_server_sign que você encontrou no site de destino
s_s_c_web_server_sign2StringSimValor do parâmetro s_s_c_web_server_sign2 que você encontrou no site de destino
pageurlStringSimURL completa da página onde você vê o captcha KeyCaptcha
header_acaoIntegerNão
Defina como 1 para incluir cabeçalho Access-Control-Allow-Origin:*
Padrão: 0
pingbackStringNãoURL para resposta de pingback (callback)
proxyStringNãoFormato do proxy: login:senha@123.123.123.123:3128
proxytypeStringNãoTipo do seu proxy: HTTP, HTTPS, SOCKS4, SOCKS5
userAgentStringNãoSeu userAgent usado para resolver o captcha

Lista de parâmetros de solicitação GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimget - obter a resposta para seu captcha
idIntegerSimID do captcha retornado por task

Exemplo de URL de Solicitação

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

Grid

Resolver reCAPTCHA V2 com esse método antigo é menos preciso e mais complexo. Por isso, recomendamos usar o novo método. Mas o método antigo é mais barato e ainda o suportamos.

Podemos resolver recaptchas com diferentes grades como 3x3, 2x4, 4x4.

Também pode resolver reCAPTCHA V2 com o método ClickCaptcha se for mais adequado para si.

E, claro, suportamos desafios de reCAPTCHA V2 quando tem de selecionar um objeto ou alguns objetos. Leia mais aqui.

Para resolver o reCAPTCHA V2 você deve:

1. Clique na caixa de seleção inicial do reCAPTCHA. Você receberá um conjunto de imagens e uma instrução que lhe dirá o que clicar. Na verdade, é uma imagem com a grade nela.

2. Opcional: determine a grade e defina-a na sua requisição com os parâmetros recaptchacols e recaptcharows. Se não for definido, verificaremos o tamanho da imagem. Se for 300x300px, colocamos uma grade 3x3. Se o tamanho for diferente, colocamos uma grade 4x4.

3. Envie uma requisição HTTP POST para a nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task fornecendo o parâmetro recaptcha definido como 1.

O servidor aceita imagens em formato multipart ou base64. Você deve enviar apenas o conjunto de imagens sem a grade e a caixa azul.

Também pode fornecer instruções como uma imagem usando o parâmetro imginstructions. Para mais informações, por favor, verifique a lista completa de parâmetros na tabela abaixo.

4. O servidor retornará o ID do captcha ou um código de erro se algo der errado.

5. Faça um timeout de 5 segundos e envie uma requisição HTTP GET para a nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

Se o captcha já estiver resolvido, o servidor retornará a resposta em JSON com os números das células da grade que você precisa clicar, como: {"status":1,"request":"click:3/8/9/."}

As células da grade são numeradas a partir do número 1, da esquerda para a direita, de cima para baixo. Se a grade contiver mais de 9 células, as letras a-g são usadas para as células 10-16.

Se o captcha ainda não estiver resolvido, o servidor retornará o resultado CAPTCHA_NOT_READY. Tente novamente a sua requisição após 5 segundos.

Se algo der errado, o servidor retornará um código de erro.

6. Você simula cliques nas células da resposta.

Lista de parâmetros de solicitação POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimpost
recaptchaIntegerSimDefina como 1 para resolver reCAPTCHA V2 com método de grade
bodyStringSimBASE64_ENCODED_IMAGE
textinstructionsStringSimExemplo: Selecione todos os quadrados com semáforos
pageurlStringSimURL completa da página onde você vê o captcha
recaptchacolsIntegerNãoNúmero de colunas da grade (padrão: 3 para imagens 300x300px, 4 para outras)
recaptcharowsIntegerNãoNúmero de linhas da grade (padrão: 3 para imagens 300x300px, 4 para outras)
imginstructionsStringNãoImagem com as instruções do captcha (formato base64 ou multipart)
header_acaoIntegerNão
Defina como 1 para incluir cabeçalho Access-Control-Allow-Origin:*
Padrão: 0
pingbackStringNãoURL para resposta de pingback (callback)
jsonIntegerNão
0 - o servidor enviará a resposta como texto simples
1 - diz ao servidor para enviar a resposta como JSON
Padrão: 0
proxyStringNãoFormato do proxy: login:senha@123.123.123.123:3128
proxytypeStringNãoTipo do seu proxy: HTTP, HTTPS, SOCKS4, SOCKS5
userAgentStringNãoSeu userAgent usado para resolver o captcha

Lista de parâmetros de solicitação GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimget - obter a resposta para seu captcha
idIntegerSimID do captcha retornado por task

Exemplo de URL de Solicitação

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

ClickCaptcha

Este método permite resolver qualquer captcha que exija clicar em imagens, como o Ghost Captcha do Snapchat, reCAPTCHA V2, ASIRRA, etc.

Para resolver qualquer ClickCaptcha você precisa:

  • Obter uma imagem e uma instrução que indica o que clicar.
  • Enviar uma requisição HTTP POST para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task fornecendo o parâmetro coordinatescaptcha definido como 1.
  • Você pode fornecer uma instrução como texto usando o parâmetro textinstructions, mas não é obrigatório se a instrução já estiver indicada na imagem.
  • Se algo der errado, o servidor retornará um código de erro.
  • Aguarde 5 segundos e envie uma requisição HTTP GET para nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.
  • Se o captcha já estiver resolvido, o servidor retornará a resposta em JSON com as coordenadas dos pontos onde você deve clicar, por exemplo: {"status":1,"request":[{"x":"132","y":"73"},{"x":"138","y":"210"},{"x":"137","y":"133"}]}. Onde o ponto com x=0,y=0 é o canto superior esquerdo da imagem.
  • Se o captcha ainda não estiver resolvido, o servidor retornará o resultado CAPCHA_NOT_READY. Tente novamente após 5 segundos.
  • Se algo der errado, o servidor retornará um código de erro.
  • Você simula cliques nas coordenadas da resposta.

Lista de parâmetros de requisição POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

Parâmetro POSTTipoObrigatórioDescrição
keyStringSimSua chave da API
methodStringSimpost - define que você está enviando uma imagem com formulário multipart.
base64 - define que você está enviando uma imagem codificada em base64
coordinatescaptchaIntegerSim1 - define que você está enviando captcha como imagem
bodyStringSimBASE64_ENCODED_IMAGE
textinstructionsStringSimTexto com instrução para resolver ClickCaptcha. Por exemplo: clique em imagens com fantasmas. Não obrigatório se a imagem já contém a instrução.
Max 140 caracteres, Encoding: UTF-8
imginstructionsImageSimImagem com instrução para resolver reCAPTCHA. Não obrigatório se você está enviando a instrução como texto com textinstructions.
Max 400x150px, 100 kB
min_clicksIntegerNãoO número mínimo de cliques para realizar na imagem
Padrão: 1
max_clicksIntegerNãoO número máximo de cliques que podem ser realizados na imagem
languageIntegerNão0 - não especificado
1 - captcha cirílico
2 - captcha latino
Padrão: 0
header_acaoIntegerNão0 - desabilitado
1 - habilitado. Se habilitado o task incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta. Usado para requisições AJAX cross-domain em aplicações web. Também suportado por res.
Padrão: 0
pingbackStringNãoURL para pingback (callback) que será enviado quando o captcha for resolvido. A URL deve estar registrada no servidor.

Lista de parâmetros de requisição GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave da API
actionStringSimget - obter a resposta do seu captcha
idIntegerSimID do captcha retornado por task.

Exemplo de URL da requisição:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

RotateCaptcha

RotateCaptcha é um tipo de captcha onde você precisa rotacionar imagens para resolvê-lo. O mais popular é o FunCaptcha.

FunCaptcha Example

Para resolver o RotateCaptcha você precisa:

  • Obter uma imagem ou várias imagens que devem ser rotacionadas.
  • Opcionalmente: determine o ângulo para um passo de rotação e forneça-o como um valor para o parâmetro angle. Se não for definido, usaremos o valor padrão para FunCaptcha: 40 graus. A lista completa de parâmetros está na tabela abaixo.
  • Envie as imagens para o nosso servidor com uma requisição HTTP POST para a nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task definindo o parâmetro method como rotatecaptcha. O servidor aceita imagens apenas no formato multipart. O servidor retornará o ID do captcha ou um código de erro se algo der errado.
  • Faça um timeout de 5 segundos e envie uma requisição HTTP GET para a nossa URL da API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado. Se o captcha já estiver resolvido, o servidor retornará a resposta em JSON com os ângulos para cada imagem, como: {"status":1,"request":"4012001-120"}. Valores positivos significam que as imagens devem ser rotacionadas no sentido horário. Valores negativos significam que as imagens devem ser rotacionadas no sentido anti-horário. Se o captcha ainda não estiver resolvido, o servidor retornará o resultado CAPCHA_NOT_READY. Tente novamente sua requisição após 5 segundos. Se algo der errado, o servidor retornará um código de erro.
  • Rotacione as imagens nos ângulos fornecidos para resolver o seu RotateCaptcha.

Lista de parâmetros de requisição POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

Parâmetro POSTTipoObrigatórioDescrição
keyStringSimSua chave da API
methodStringSimMétodo de resolução de captcha. rotatecaptcha - define que você está enviando RotateCaptcha
bodyImageSim*Imagem para rotacionar em formato base64.
angleIntegerNãoÂngulo para um passo de rotação em graus. Se não for definido, usaremos o valor padrão para FunCaptcha: 40 graus.
Padrão: 40
fileImageSim*Imagem para rotacionar em formato multipart. * - obrigatório se você enviar a imagem como arquivo
header_acaoIntegerNão0 - desabilitado
1 - habilitado. Se habilitado o task incluirá o cabeçalho Access-Control-Allow-Origin:* na resposta. Usado para requisições AJAX cross-domain em aplicações web. Também suportado por res.
Padrão: 0
pingbackStringNãoURL para pingback (callback) que será enviado quando o captcha for resolvido. A URL deve estar registrada no servidor. Mais informações aqui.

Lista de parâmetros de requisição GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave da API
actionStringSimget - obter a resposta do seu captcha
idIntegerSimID do captcha retornado por task.

Exemplo de URL da requisição:

https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149

CaptchaFox

Um método baseado em token para resolver automaticamente captchas do CaptchaFox através do SolveCaptcha.

Lista de parâmetros de requisição POST para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

ParâmetroTipoObrigatórioDescrição
keyStringSimChave da API do SolveCaptcha.
methodStringSimcaptchafox
sitekeyStringSimO valor do parâmetro sitekey encontrado na página ou capturado nas requisições de rede.
pageurlStringSimA URL completa da página contendo o captcha.
proxyStringSimSeu proxy no formato: login:password@123.123.123.123:3128
proxytypeStringSimTipo de proxy: HTTP, HTTPS, SOCKS4, SOCKS5
useragentStringSimO User-Agent do navegador usado para acessar a página com o captcha.

hCaptcha

hCaptcha é um tipo popular de captcha usado por muitos sites para verificar se o usuário é humano. Para resolver o hCaptcha, você precisa extrair o valor do parâmetro sitekey do código-fonte da página e enviar uma solicitação para nossa API contendo o sitekey extraído e a URL completa da página.

Para resolver hCaptcha com nossa API, siga os passos abaixo:

• Encontre o parâmetro data-sitekey no código-fonte da página onde o hCaptcha está localizado.

• Copie o valor do parâmetro sitekey (algo como 6LfP0CITAAAAAHq9FOgCo7v_fb0).

• Envie uma solicitação HTTP POST para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task com os parâmetros necessários. Veja a lista completa de parâmetros na seção de código ao lado.

Exemplo de Resposta da Solicitação POST:

{"status": 1, "request": "h1190747339"}

• Com o ID da tarefa retornado na propriedade request, faça uma solicitação HTTP GET para o endpoint de resultados para obter o estado da tarefa.

• Defina um tempo limite de 15 a 20 segundos e envie uma solicitação HTTP GET para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

Parâmetros da Solicitação POST

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimDeve ser hcaptcha
sitekeyStringSimO valor do parâmetro data-sitekey encontrado na página
pageurlStringSimURL completa da página onde o hCaptcha está localizado

Parâmetros da Solicitação GET (Resultado)

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimDeve ser get
idStringSimO ID da tarefa retornado na solicitação POST

Respostas do Servidor

Se o captcha já foi resolvido, o servidor responderá com um token de resposta no formato:

{"status":1,"request":"TOKEN_HCAPTCHA"}

Se ainda não resolvido: CAPCHA_NOT_READY. Repita a solicitação em 5 segundos.

Se houver erro: um código de erro será retornado.

Temu Captcha

Método para resolver Temu CAPTCHA utilizando imagens. Este é um captcha baseado em imagem onde você precisa enviar a imagem principal e as partes do quebra-cabeça que precisam ser movidas.

Especificação do Método Baseado em Imagem

Utilizamos o parâmetro body (imagem principal em formato base64) e os parâmetros part1, part2 e part3 (imagens das partes do quebra-cabeça que precisam ser movidas).

• Você precisa obter todas as imagens e convertê-las para o formato base64.

• Envie uma solicitação HTTP POST para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task com os parâmetros necessários.

Exemplo de Resposta da Solicitação POST:

{"status": 1, "request": "t1234567890"}

• Com o ID da tarefa retornado na propriedade request, faça uma solicitação HTTP GET para o endpoint de resultados para obter o estado da tarefa.

• Defina um tempo limite de 15 a 20 segundos e envie uma solicitação HTTP GET para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

Parâmetros da Solicitação POST

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimDeve ser temuimage
bodyStringSimA imagem principal do captcha codificada em base64
part1StringSimPrimeira parte do quebra-cabeça codificada em base64
part2StringSimSegunda parte do quebra-cabeça codificada em base64
part3StringSimTerceira parte do quebra-cabeça codificada em base64

Parâmetros da Solicitação GET (Resultado)

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimDeve ser get
idStringSimO ID da tarefa retornado na solicitação POST

Respostas do Servidor

Se o captcha já foi resolvido, o servidor responderá com as coordenadas das partes do quebra-cabeça no formato:

{"status":1,"request":"COORDINATES_RESULT"}

Se ainda não resolvido: CAPCHA_NOT_READY. Repita a solicitação em 5 segundos.

Se houver erro: um código de erro será retornado.

Canvas Captcha

O método Canvas é utilizado quando o desafio reCAPTCHA exige que você selecione ao redor de um objeto na imagem. O servidor retorna coordenadas de pontos que você precisa clicar para selecionar a área ao redor do objeto.

Formato da Resposta

O servidor retornará o resultado no seguinte formato:

canvas:x,y,x,y,x,y;x,y,x,y,x,y;

Onde cada par de x e y são coordenadas dos pontos que você precisa clicar para selecionar uma área ao redor do objeto. Se houver mais de uma área, as coordenadas serão separadas por ponto e vírgula.

Exemplos:

  • canvas:5,5,3,91,93,90,90,7,8,6;- uma área
  • canvas:5,5,3,91,93,90,90,7,8,6;208,211,208,287,294,294,293,209,207,210;- duas áreas

O ponto 0,0 é o canto superior esquerdo da imagem. Você precisa clicar nesses pontos um por um para passar o desafio.

• Para usar o método Canvas, defina o parâmetro canvas como 1.

• Envie a imagem do reCAPTCHA codificada em base64 junto com as instruções de texto ou imagem.

• Envie uma solicitação HTTP POST para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/task

Exemplo de Resposta da Solicitação POST:

{"status": 1, "request": "c1234567890"}

• Com o ID da tarefa retornado na propriedade request, faça uma solicitação HTTP GET para o endpoint de resultados.

• Defina um tempo limite de 15 a 20 segundos e envie uma solicitação HTTP GET para a URL da nossa API: https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res para obter o resultado.

Parâmetros da Solicitação POST

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
methodStringSimbase64 - para imagem codificada em base64
recaptchaIntegerSimDeve ser 1 - indica que você está enviando reCAPTCHA como imagem
canvasIntegerNão (padrão: 0)1 - ativa o método canvas para seleção de área
bodyStringSimImagem do reCAPTCHA codificada em base64 (máx. 100 kB)
textinstructionsStringSim*Texto com instrução para resolver (máx. 140 caracteres, UTF-8). Ex: "selecione imagens com árvores". *Não obrigatório se enviar imginstructions.
imginstructionsStringSim*Imagem com instrução codificada em base64 (máx. 100x100px, 25 kB). *Não obrigatório se enviar textinstructions.
recaptcharowsIntegerNãoNúmero de linhas na grade do reCAPTCHA
recaptchacolsIntegerNãoNúmero de colunas na grade do reCAPTCHA
can_no_answerIntegerNão (padrão: 0)1 - indica que pode não haver imagens correspondentes. Você receberá "No_matching_images" como resposta se aplicável.
languageIntegerNão (padrão: 0)0 - não especificado, 1 - cirílico, 2 - latino

Nota: Você deve enviar a imagem do reCAPTCHA em si, não uma captura de tela. Não combine a imagem com nada, envie como está.

Parâmetros da Solicitação GET (Resultado)

ParâmetroTipoObrigatórioDescrição
keyStringSimSua chave de API
actionStringSimDeve ser get
idStringSimO ID da tarefa retornado na solicitação POST

Respostas do Servidor

Se o captcha já foi resolvido, o servidor responderá com as coordenadas no formato:

{"status":1,"request":"canvas:5,5,3,91,93,90,90,7,8,6;"}

Se ainda não resolvido: CAPCHA_NOT_READY. Repita a solicitação em 5 segundos.

Se não houver imagens correspondentes (quando can_no_answer=1): No_matching_images.

Se houver erro: um código de erro será retornado.

Error Handling

É muito importante usar o tratamento de erros adequado no seu código para evitar a suspensão da sua conta e interrupção do serviço.

Normalmente, se algo estiver errado com sua requisição, o servidor retornará um erro.

Abaixo você pode encontrar tabelas com listas de erros com descrição:

Erros podem ser retornados como texto simples ou como JSON se você forneceu o parâmetro json=1.

Em casos muito raros, o servidor pode retornar uma página HTML com texto de erro como 500 ou 502 - por favor, tenha isso em mente e trate esses casos corretamente.

Se você recebeu algo que não parece com a resposta ou código de erro - faça um timeout de 5 segundos e então tente novamente sua requisição.

Lista de erros de task

Código de ErroDescriçãoAção
ERROR_WRONG_USER_KEYVocê forneceu o valor do parâmetro key em formato incorreto, deve conter 32 símbolos.Pare de enviar requisições. Verifique sua chave da API.
ERROR_KEY_DOES_NOT_EXISTA chave fornecida não existe.Pare de enviar requisições. Verifique sua chave da API.
ERROR_ZERO_BALANCEVocê não tem dinheiro na sua conta.Pare de enviar requisições. Faça um depósito na sua conta para continuar resolvendo captchas.
ERROR_PAGEURLO parâmetro pageurl está ausente na sua requisição.Pare de enviar requisições e altere seu código para fornecer um parâmetro pageurl válido. Mais informações.
ERROR_NO_SLOT_AVAILABLEVocê pode receber este erro em dois casos:
1. Se você resolver reCAPTCHA: a fila dos seus captchas que não foram distribuídos para trabalhadores está muito longa. O limite da fila muda dinamicamente e depende da quantidade total de captchas aguardando solução e geralmente está entre 50 e 100 captchas.
2. Se você resolver Image Captcha: sua taxa máxima para captchas de imagem é menor que a taxa atual no servidor. Você pode alterar sua taxa máxima nas configurações da sua conta.		Se você recebeu este erro, não tente enviar sua requisição novamente imediatamente. Faça um timeout de 2-3 segundos e então tente enviar sua requisição.
ERROR_ZERO_CAPTCHA_FILESIZEO tamanho da imagem é menor que 100 bytes.Verifique o arquivo de imagem.
ERROR_TOO_BIG_CAPTCHA_FILESIZEO tamanho da imagem é maior que 100 kB.Verifique o arquivo de imagem.
ERROR_WRONG_FILE_EXTENSIONO arquivo de imagem tem extensão não suportada. Extensões aceitas: jpg, jpeg, gif, png.Verifique o arquivo de imagem.
ERROR_IMAGE_TYPE_NOT_SUPPORTEDO servidor não consegue reconhecer o tipo de arquivo de imagem.Verifique o arquivo de imagem.
ERROR_IP_NOT_ALLOWEDA requisição foi enviada do IP que não está na lista dos seus IPs permitidos.Verifique a lista dos seus IPs permitidos aqui.
IP_BANNEDSeu endereço IP está banido devido a muitas tentativas frequentes de acessar o servidor usando chaves de autorização incorretas.Para remover o banimento, entre em contato com nossa equipe de suporte.
ERROR_CAPTCHAIMAGE_BLOCKEDVocê enviou uma imagem marcada em nosso banco de dados como não reconhecível. Geralmente isso acontece se o site onde você encontrou o captcha parou de enviar captchas e começou a enviar a imagem "negar acesso".Tente contornar as limitações do site.
MAX_USER_TURNVocê fez mais de 60 requisições para task dentro de 3 segundos. Sua conta está banida por 10 segundos. O banimento será removido automaticamente.Defina pelo menos 100 ms de timeout entre requisições para task.
ERROR: NNNNVocê excedeu o limite de requisições e sua conta está temporariamente suspensa.Você deve definir timeouts apropriados. Consulte Limites de requisições para mais informações.

Lista de erros de res

Código de ErroDescriçãoAção
CAPCHA_NOT_READYSeu captcha ainda não está resolvido.Faça um timeout de 5 segundos e repita sua requisição.
ERROR_CAPTCHA_UNSOLVABLENão somos capazes de resolver seu captcha - três dos nossos trabalhadores foram incapazes de resolvê-lo ou não recebemos uma resposta dentro de 90 segundos (300 segundos para reCAPTCHA V2). Não vamos cobrar você por essa requisição.Você pode tentar enviar seu captcha novamente.
ERROR_WRONG_USER_KEYVocê forneceu o valor do parâmetro key em formato incorreto, deve conter 32 símbolos.Pare de enviar requisições. Verifique sua chave da API.
ERROR_KEY_DOES_NOT_EXISTA chave fornecida não existe.Pare de enviar requisições. Verifique sua chave da API.
ERROR_WRONG_ID_FORMATVocê forneceu o ID do captcha em formato errado. O ID pode conter apenas números.Verifique o ID do captcha ou seu código que obtém o ID.
ERROR_WRONG_CAPTCHA_IDVocê forneceu um ID de captcha incorreto.Verifique o ID do captcha ou seu código que obtém o ID.
ERROR_BAD_DUPLICATESErro é retornado quando o recurso de 100% de precisão está habilitado. O erro significa que o número máximo de tentativas foi atingido, mas o número mínimo de correspondências não foi encontrado.Você pode tentar enviar seu captcha novamente.
REPORT_NOT_RECORDEDErro é retornado para sua requisição de reclamação se você já reclamou muitos captchas corretamente resolvidos.Certifique-se de estar enviando requisições de reclamação apenas para captchas incorretamente resolvidos.
ERROR: NNNNOnde NNNN é um código de erro numérico. Você excedeu o limite de requisições e sua conta está temporariamente suspensa.Você deve definir timeouts apropriados. Consulte Limites de requisições para mais informações.

Limites de Requisições

Por favor, lembre-se e entenda que cada requisição à nossa API gera múltiplas requisições aos nossos bancos de dados. É por isso que pedimos para definir timeouts apropriados para suas requisições e usar tratamento de erros adequado para casos em que o servidor retorna um erro (mensagem de erro, erro http ou página HTML com erro).

Por exemplo:

  • Se o servidor retornar ERROR_NO_SLOT_AVAILABLE, faça um timeout de 5 segundos antes de enviar a próxima requisição.
  • Se o servidor retornar ERROR_ZERO_BALANCE, defina o timeout para 60 segundos.
  • Após enviar um captcha, aguarde pelo menos 5 segundos (10-20 para reCAPTCHA) e somente então tente obter a resposta.
  • Se o captcha ainda não estiver resolvido - tente novamente obter a resposta após 5 segundos.

Aviso: Se seus timeouts estiverem configurados incorretamente, sua conta ou endereço IP será temporariamente bloqueado e o servidor retornará um erro. Veja a lista de códigos de erro na tabela abaixo.

Lista de códigos de erro para limitações de requisições

Código de ErroTempo de BloqueioRazão do Bloqueio
ERROR: 100110 minutosVocê recebeu 120 erros ERROR_NO_SLOT_AVAILABLE em um minuto porque sua oferta atual é menor que a oferta atual no servidor
ERROR: 10025 minutosVocê recebeu 120 erros ERROR_ZERO_BALANCE em um minuto porque seu saldo está zerado
ERROR: 100330 segundosVocê está recebendo ERROR_NO_SLOT_AVAILABLE porque está enviando muitos captchas e o servidor tem uma fila longa dos seus captchas que não foram distribuídos para trabalhadores. Você recebeu três vezes mais erros do que a quantidade de captchas que você enviou (mas não menos que 120 erros). Aumente o timeout se você ver este erro.
ERROR: 100410 minutosSeu endereço IP está bloqueado porque houve 5 requisições com chave de API incorreta do seu IP.
ERROR: 10055 minutosVocê está fazendo muitas requisições para res para obter respostas. Usamos a seguinte regra para bloquear sua conta: R > C * 20 + 1200

Onde:
R - a quantidade de suas requisições
C - a quantidade de captchas que você enviou

Isso significa que você não deve fazer mais de 20 requisições para res por cada captcha. Lembre-se que a requisição de saldo enviada para res também conta! Para obter sua resposta mais rápido sem risco de ser bloqueado, você pode usar o recurso de pingback e enviaremos a resposta quando seu captcha for resolvido.

Usando Proxies

Obtenha os melhores proxies residenciais na 2Captcha Proxy 🔥 Basta seguir o link para obter 50% de desconto – disponível para todos os usuários do SolveCaptcha!

Proxies podem ser usados para resolver reCAPTCHA V2 e FunCaptcha do mesmo endereço IP de onde você carrega a página.

Usar proxies não é obrigatório no momento, mas no futuro os algoritmos de reCAPTCHA e FunCaptcha podem ser alterados e será necessário.

E mesmo agora alguns sites verificam o endereço IP usado para resolver o reCAPTCHA V2. Então recomendamos que você esteja pronto para essas mudanças.

Se você nos enviar o proxy, verificamos a disponibilidade tentando abrir o site através do seu proxy, e se não conseguirmos fazer isso, não usaremos seu proxy. Se conseguirmos usar seu proxy - carregaremos o reCAPTCHA através dele para resolução.

Não temos nossos próprios servidores proxy que possamos oferecer a você, então você deve usar serviços de terceiros ou configurar seu próprio proxy.

Suportamos: SOCKS4, SOCKS5, HTTP, HTTPS com autenticação por endereço IP ou login e senha.

Se você usar autenticação por IP:

Se seu proxy usa autenticação por IP, você deve adicionar nossos endereços IP à lista de IPs permitidos do proxy: 138.201.188.166

Então forneça o endereço IP do seu proxy e a porta como valor para o parâmetro proxy. E o tipo do seu proxy como valor para o parâmetro proxytype.

Se seu proxy usa autenticação por login/senha, você deve incluir suas credenciais no parâmetro proxy.

Parâmetros POST para proxies

Parâmetro POSTTipoObrigatórioDescrição
proxyStringNãoFormato para autenticação por IP: IP_address:PORT (Exemplo: proxy=123.123.123.123:3128)
Formato para autenticação por login/senha: login:password@IP_address:PORT (Exemplo: proxy=proxyuser:strongPassword@123.123.123.123:3128)
proxytypeStringNãoTipo do seu proxy: HTTP, HTTPS, SOCKS4, SOCKS5.
Exemplo: proxytype=SOCKS4

Parâmetro de Cookies

Nossa API fornece suporte aprimorado a cookies para reCAPTCHA V2 e reCAPTCHA V2 Enterprise.

Você pode enviar seus próprios cookies especificando-os no parâmetro json_cookies usando o formato mostrado abaixo. Estes cookies serão aplicados no navegador do nosso trabalhador.

Uma vez que o captcha seja resolvido com sucesso, retornaremos todos os cookies definidos para o domínio google.com e o site alvo especificado no parâmetro pageurl.

Para recuperar os cookies, inclua o parâmetro json=1 na sua requisição para res.

Formato de cookie:

{
  "json_cookies": [
    {
      "name": "my-cookie-name-1",
      "value": "my-cookie-val-1",
      "domain": "example.com",
      "hostOnly": true,
      "path": "/",
      "secure": true,
      "httpOnly": false,
      "session": false,
      "expirationDate": 1665434653,
      "sameSite": "strict"
    },
    {
      "name": "my-cookie-name-2",
      "value": "my-cookie-val-2",
      "domain": ".google.com",
      "hostOnly": false,
      "path": "/",
      "secure": true,
      "httpOnly": false,
      "session": false,
      "expirationDate": 1668015805.8028,
      "sameSite": "no_restriction"
    }
  ]
}

Parâmetros de Cookie

ParâmetroTipoObrigatórioDescrição
nameStringSimNome do cookie
valueStringSimValor do cookie
domainStringSimDomínio do cookie (ex: example.com ou .google.com)
hostOnlyBooleanNãoSe o cookie é apenas para o host específico (true) ou para o domínio (false)
pathStringNãoCaminho do cookie (geralmente "/")
secureBooleanNãoSe o cookie deve ser enviado apenas em conexões HTTPS (true)
httpOnlyBooleanNãoSe o cookie não deve ser acessível via JavaScript (true)
sessionBooleanNãoSe o cookie é uma sessão (true) ou persistente (false)
expirationDateNumberNãoData de expiração do cookie em Unix timestamp (obrigatório se session for false)
sameSiteStringNãoPolítica SameSite do cookie (strict, lax, no_restriction)

Propriedades Obrigatórias para Cookies Enviados

Ao enviar cookies, os seguintes parâmetros obrigatórios devem ser especificados:

PropriedadeTipoDescrição
domainStringO domínio ao qual o cookie pertence
nameStringO nome do cookie
valueStringO conteúdo do cookie
secureBooleanDetermina se o atributo Secure deve ser definido (apenas para transmissão em uma conexão segura)

Todos os cookies enviados devem incluir os parâmetros listados acima para serem aplicados corretamente no navegador do trabalhador.

Métodos Adicionais

Você também pode obter algumas informações adicionais com nossa API, como saldo, taxa atual, etc.

Por favor, verifique os parâmetros disponíveis na tabela abaixo.

Lista de parâmetros de requisição GET para https://8gjn58nj23.execute-api.us-west-2.amazonaws.com/v001/res

Parâmetro GETTipoObrigatórioDescrição
keyStringSimSua chave da API
actionStringSimgetbalance - obter seu saldo
get - obter respostas para múltiplos captchas com uma requisição.
Requer o parâmetro ids.
jsonIntegerNão0 - o servidor enviará a resposta como texto plano
1 - indica ao servidor para enviar a resposta como JSON
Padrão: 0