Este guia se limita a ambientes próprios, QA, staging ou pré-produção com autorização explícita. Os exemplos usam páginas internas, dados fictícios e endpoints de validação controlados pela equipe. Não há orientação para automatizar serviços de terceiros, compras reais, filas públicas ou controles de acesso fora do seu ambiente.
Escopo seguro
Use CDP apenas para diagnosticar páginas internas, requests de rede e verificação de backend em ambientes autorizados.
Usar CDP para diagnóstico de rede
Ative eventos de rede para observar carregamento do script CAPTCHA, resposta do widget e chamada do endpoint interno. O objetivo é entender lifecycle, status HTTP e parâmetros de QA.
Detectar sitekey em página de teste interna
Abra https://staging.example.com/captcha-demo, leia atributos do widget e compare a sitekey com a configuração esperada do ambiente.
Enviar tarefa CaptchaAI a partir do QA
Quando o smoke test confirmar a sitekey, envie uma tarefa CaptchaAI com a pageurl staging.
import os, time, requests
API_KEY = os.environ['CAPTCHAAI_API_KEY']
SITEKEY = os.environ['QA_CAPTCHA_SITEKEY']
def criar_tarefa_captcha(pageurl):
resposta = requests.post('https://ocr.captchaai.com/in.php', data={
'key': API_KEY,
'method': 'userrecaptcha',
'googlekey': SITEKEY,
'pageurl': pageurl,
'json': 1,
}).json()
return resposta['request']
def aguardar_resultado(task_id):
while True:
time.sleep(5)
resposta = requests.get('https://ocr.captchaai.com/res.php', params={
'key': API_KEY,
'action': 'get',
'id': task_id,
'json': 1,
}).json()
if resposta.get('status') == 1:
return resposta['request']
task_id = criar_tarefa_captcha('https://staging.example.com/captcha-demo')
token_qa = aguardar_resultado(task_id)
print({'token_recebido': bool(token_qa)})
Verificar resposta no backend
Encaminhe a resposta para um endpoint interno, registre status e compare com os logs do provedor CAPTCHA.
Solução de problemas
Falhas comuns vêm de domínio staging ausente, sitekey antiga, action divergente, token expirado ou endpoint interno apontando para configuração incorreta.
Critérios de publicação
Antes de publicar a mudança testada, confirme que a documentação aponta para ambiente próprio, que os exemplos usam dados fictícios, que nenhum endpoint de produção é acionado pelo teste e que os logs contêm correlação suficiente para auditoria. A página staging deve ter domínio autorizado, sitekey esperada, configuração de backend separada e política clara de expiração. Quando o resultado variar, trate os números como amostra interna: repita a medição, anote a janela de execução e compare apenas cenários equivalentes.
Guias relacionados seguros
- Início rápido da CaptchaAI
- Testes QA autorizados de CAPTCHA
- Testes de endpoint CAPTCHA em formulários próprios
- Depuração quando o navegador falha e a API funciona
- Resolver reCAPTCHA v2 com API
- Resolver Cloudflare Turnstile com API
- Resolver GeeTest v3 com API
Valide a integração CAPTCHA do seu ambiente próprio com a CaptchaAI.
