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.
Por que separar perfis em QA
Perfis separados evitam contaminação de cookies, storage, contas e flags de experimento entre cenários. Isso torna falhas reproduzíveis e reduz falsos positivos em testes CAPTCHA.
O que deve ser isolado por perfil
Isole cookies, localStorage, sessionStorage, cache, conta de teste, feature flags, idioma, região de staging e configuração CAPTCHA. Não misture cenários de login, checkout e registro no mesmo perfil.
Exemplo de estado de perfil QA
Use um arquivo JSON com profile_id, qa_account, environment, captcha_type, created_at e last_run_id. O perfil deve ser recriado quando o caso exigir estado limpo.
Integração CaptchaAI em uma suíte QA interna
A suíte abre o perfil, acessa a página staging, envia a tarefa CaptchaAI e valida o resultado no backend interno.
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)})
Solução de problemas
Se um teste passa isolado e falha em lote, verifique vazamento de cookies, storage persistente, conta QA reutilizada e limpeza incompleta entre execuções.
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.