Usando o Fiddler para inspecionar o tráfego da API CaptchaAI

Quando a solução CAPTCHA falha e seus logs não mostram detalhes suficientes, a interceptação do tráfego HTTP real revela o que está acontecendo. O Fiddler captura cada solicitação e resposta entre seu código e a API CaptchaAI, permitindo que você veja cargas, cabeçalhos e tempo exatos.

Quando usar o Fiddler para depuração

Configurando o Fiddler para tráfego HTTPS

Etapa 1: instalar e configurar a descriptografia HTTPS

O Fiddler atua como um proxy local que intercepta o tráfego HTTPS. Você precisa ativar a descriptografia HTTPS para ver as cargas úteis da API CaptchaAI:

Violinista em todos os lugares:

1. Abra Configurações -> HTTPS
2. Ative "Capturar tráfego HTTPS"
3. Instale o certificado raiz do Fiddler quando solicitado
4. Confie no certificado no armazenamento de certificados do seu sistema operacional

Fiddler Clássico (Windows):

1. Ferramentas -> Opções -> HTTPS
2. Marque "Descriptografar tráfego HTTPS"
3. Clique em "Ações" → "Certificado Raiz Confiável"

Etapa 2: configure seu código para usar o proxy do Fiddler

O Fiddler ouve no 127.0.0.1:8866 (Fiddler Everywhere) ou 127.0.0.1:8888 (Fiddler Classic).

Python (solicitações):

import requests

proxies = {
    "http": "http://127.0.0.1:8866",
    "https": "http://127.0.0.1:8866",
}

# Submit CAPTCHA task through Fiddler
response = requests.post(
    "https://ocr.captchaai.com/in.php",
    data={
        "key": "YOUR_API_KEY",
        "method": "userrecaptcha",
        "googlekey": "SITE_KEY",
        "pageurl": "https://example.com",
        "json": 1,
    },
    proxies=proxies,
    verify=False,  # Required for Fiddler's self-signed cert
)
print(response.json())

JavaScript (Node.js com axios):

const axios = require("axios");
const HttpsProxyAgent = require("https-proxy-agent");

const agent = new HttpsProxyAgent("http://127.0.0.1:8866");

async function submitTask() {
  const response = await axios.post(
    "https://ocr.captchaai.com/in.php",
    new URLSearchParams({
      key: "YOUR_API_KEY",
      method: "userrecaptcha",
      googlekey: "SITE_KEY",
      pageurl: "https://example.com",
      json: 1,
    }),
    {
      httpsAgent: agent,
      proxy: false, // Disable axios default proxy handling
    }
  );
  console.log(response.data);
}

submitTask();

Observação: verify=False (Python) desativa a verificação SSL para o certificado de interceptação do Fiddler. Use isso apenas durante a depuração – remova-o na produção.

Filtrando tráfego CaptchaAI

Adicione filtros para ver apenas solicitações CaptchaAI em uma sessão ocupada.

Filtros do Fiddler em todos os lugares

1. Clique na guia Filtros
2. Adicione uma regra: Host → contains → ocr.captchaai.com
3. Aplicar o filtro

Filtros clássicos do Fiddler

1. Clique na guia Filtros
2. Marque "Usar filtros"
3. Em "Hosts", selecione "Mostrar apenas os seguintes hosts"
4. Digite: ocr.captchaai.com

Agora apenas as solicitações da API CaptchaAI aparecem na lista de sessões.

Inspecionando Solicitação e Resposta

Enviar solicitação (in.php)

Ao capturar o envio de uma tarefa, inspecione estes campos no Fiddler:

Solicitação de enquete (res.php)

Ao pesquisar resultados:

Problemas comuns visíveis no Fiddler

Usando pontos de interrupção

Os pontos de interrupção pausam as solicitações antes de serem enviadas, permitindo que você as modifique:

Definindo um ponto de interrupção

Violinista em todos os lugares:

1. Regras -> Adicionar Regra
2. Correspondência: URL contém ocr.captchaai.com/in.php
3. Ação: "Pausar antes de enviar"

Clássico do violinista:

1. Regras -> Pontos de interrupção automáticos -> Antes das solicitações
2. Ou digite bpu ocr.captchaai.com na barra QuickExec

O que fazer em um ponto de interrupção

Quando uma solicitação é pausada:

1. Inspecione o corpo da solicitação — verifique se todos os parâmetros estão corretos
2. Editar parâmetros — altere method, googlekey ou pageurl para testar valores diferentes
3. Retomar — clique em "Executar até a conclusão" para enviar a solicitação modificada
4. Verifique a resposta — veja se sua alteração corrigiu o problema

Isso é útil para testar se um valor de parâmetro está causando falhas sem alterar o código.

Repetindo solicitações com falha

Quando uma solicitação falha, você pode reproduzi-la no Fiddler:

1. Clique com o botão direito na sessão com falha
2. Selecione Replay → Solicitações de reemissão
3. A mesma solicitação é enviada novamente com cabeçalhos e corpo idênticos

Para reproduzir com modificações:

1. Clique com o botão direito → Editar no Composer **
2. Modifique os parâmetros
3. Clique em Executar

Isso permite testar correções sem reiniciar seu aplicativo.

Compondo solicitações de teste

Use o Composer do Fiddler para criar solicitações CaptchaAI do zero:

Envio de tarefa:

POST https://ocr.captchaai.com/in.php
Content-Type: application/x-www-form-urlencoded

key=YOUR_API_KEY&method=userrecaptcha&googlekey=SITE_KEY&pageurl=https://example.com&json=1

Enquete de resultados:

GET https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=get&id=TASK_ID&json=1

Isso é com menor latência do que escrever código quando você deseja apenas verificar se a API está funcionando.

Analisando o tempo

A visualização da linha do tempo do Fiddler mostra a duração da solicitação:

Exportando sessões para suporte

Se você precisar compartilhar dados de depuração com suporte CaptchaAI:

1. Selecione as sessões relevantes no Fiddler
2. Arquivo → Exportar Sessões → Sessões Selecionadas
3. Escolha o formato HTTPArchive (.har)
4. Remova sua chave de API do arquivo exportado antes de compartilhar

Find and replace your actual API key with "REDACTED" in the .har file

Solução de problemas

Perguntas frequentes

O uso do Fiddler afeta o tempo de resolução do CAPTCHA?

Minimamente. O Fiddler adiciona cerca de 1 a 5 ms de latência por solicitação devido ao salto do proxy. Isso é insignificante em comparação com os tempos de resolução do CAPTCHA (10–60 segundos). Para depuração de tempo crítico, observe que os carimbos de data/hora do Fiddler refletem quando o Fiddler recebeu os dados, não quando seu código os enviou.

Posso usar o Fiddler com solução CAPTCHA baseada em navegador?

Sim. Configure seu navegador para usar o Fiddler como proxy e você verá todas as solicitações relacionadas ao CAPTCHA, incluindo carregamento de widget, recuperação de desafio e envio de token. Isso é útil para entender todo o ciclo de vida do CAPTCHA.

Devo usar o Fiddler Classic ou o Fiddler Everywhere?

O Fiddler Everywhere é multiplataforma (Windows, macOS, Linux) com uma interface de usuário moderna. O Fiddler Classic é apenas para Windows, mas possui recursos de script mais avançados (FiddlerScript). Para depuração básica do CaptchaAI, qualquer um deles funciona.

Artigos relacionados

• Segurança da chave de API da lista de permissões de IP Captchaai
• Rotação de chave da API Captchaai
• Concorrentes de mapeamento de endpoint da API Captchaai

Próximas etapas

Mensagens de erro claras da API tornam a depuração com menor latência –comece com CaptchaAIe use o Fiddler quando precisar de uma inspeção mais profunda no nível da solicitação.

Guias relacionados:

• Repetição HTTP para depuração de API CAPTCHA
• Ferramenta CLI CaptchaAI
• Referência de códigos de erro CaptchaAI