API de reCAPTCHA Enterprise v3

Por solvethree Atualizado

Obtenha um token reCAPTCHA v3 Enterprise pelo seu backend. Configure o site uma vez e depois envie seu nome de host, ação e um proxy. Retornaremos o token com o user agent e os client hints a serem usados no envio.

Experimente a API
Nesta página

Faça a requisição

Configure um perfil de site ativo no seu espaço de trabalho antes da primeira resolução. Envie o nome de host em site e a ação reCAPTCHA real da página em action. Enterprise v3 é o padrão; use recaptchaType: v3 para v3 padrão. A tarefa não precisa de type, URL completa da página ou chave de site.

Crie a tarefa com POST https://api.solvethree.com/v1/tasks. Autentique-se com uma chave de API do espaço de trabalho no cabeçalho Authorization: Bearer.

Corpo da tarefa · substitua o destino e o proxy de exemplo
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example-recaptcha-001"
}

Envie o token

Leia solution.token quando a tarefa estiver pronta. Envie-o no campo CAPTCHA da sua aplicação pelo mesmo proxy, usando os valores retornados de userAgent e secChUa. Faça a resolução perto do momento da requisição que precisa do token; não crie um cache de tokens para usar depois.

Uma tarefa pronta significa que a solução foi gerada. Confira a resposta do destino para saber se ele aceitou a requisição.

Espera e tempos limite

A criação aguarda até 15 segundos por padrão. Use ?waitMs=0 se preferir receber um ID de tarefa imediatamente e consultar seu status periodicamente.

Pare em ready ou failed. Se a criação exceder o tempo limite, reutilize o requestId original com entradas idênticas para recuperar a tarefa. Um novo ID pode criar outra resolução faturável.

Preço

$2.00 por 1,000 resoluções, pagos com o saldo do seu espaço de trabalho. As resoluções que falharem são reembolsadas. Comece com $5 em créditos de boas-vindas; o depósito mínimo pago é de $10.

API de reCAPTCHA Enterprise v3 · solvethree