Como medir disponibilidade de provedores CAPTCHA

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 medir no próprio ambiente

Tempos de resolução CAPTCHA mudam por tipo de desafio, região, carga, integração, horário e qualidade do endpoint de verificação. Uma tabela pública sem contexto não deve ser interpretada como garantia universal. Use medições internas para decidir capacidade, alertas e orçamento.

Metodologia de medição

Separe os testes por tipo de CAPTCHA, use a mesma página staging, registre hora de envio, hora de conclusão, código de erro e resultado do backend. Calcule mediana, P90 e P99 com amostras internas suficientes para reduzir ruído.

Modelo de tabela de medição

Compatibilidade e cobertura

Inclua apenas tipos que sua aplicação realmente usa, como reCAPTCHA, Cloudflare Turnstile ou GeeTest. Documente sitekey de QA, região do runner, versão do cliente HTTP e endpoint interno de validação.

Planejamento de capacidade com seus próprios dados

Use P90 e P99 para estimar filas, timeouts e retentativas. Se a carga variar durante campanhas, rode uma amostra separada por janela de tráfego e compare apenas cenários equivalentes.

Script de benchmark

O script abaixo é um ponto de partida para medir tempos em staging. Ele não compara provedores por conclusão universal; apenas coleta dados do seu ambiente.

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 a variância crescer, confirme se a página staging está estável, se o endpoint interno responde de forma consistente e se os tipos de CAPTCHA não foram misturados no mesmo conjunto de amostras.

Perguntas frequentes

Posso usar valores públicos como previsão? Use apenas como contexto. Para decisão técnica, meça no seu próprio ambiente. Posso publicar resultados? Publique metodologia, tamanho de amostra e limitações junto dos números.

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

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.