Simule uma resposta de API em um dispositivo real

Abra o feed do dashboard e encontre uma requisição real para o endpoint. Se a linha dela mostra um corpo descriptografado, você está pronto. Se o host ainda aparece criptografado, adicione-o à lista de SSL proxy do dispositivo — pelas ações de host da linha ou nas configurações do dispositivo — e dispare a chamada de novo. Em um host que passa criptografado, o motor só consegue casar pelo nome do host; o caminho é invisível, então um mock preciso por caminho nunca dispara.

Abra a página Blocks pelo menu de configurações para uma regra global, ou vá ao dispositivo e depois em Blocks para uma regra que vale só para este celular. Adicione uma regra e preencha o método — ou deixe vazio para casar com qualquer um — e o padrão. Os padrões são os mesmos curingas de host mais caminho usados pelos breakpoints: o host, uma barra, o caminho, com um asterisco onde um segmento varia.

Defina a ação como Mock. Enquanto Block serve para fazer uma chamada falhar e Drop faz parecer que a rede sumiu, Mock serve para satisfazê-la: defina o status — o padrão é 200 —, os cabeçalhos que o app vai olhar e o corpo. Dê a ele o Content-Type que seu app interpreta; um cliente JSON que recebe uma resposta em texto falha antes de ler um byte. Salva como JSON, a regra fica assim.

Salve a regra e use o app. A próxima requisição correspondente é respondida sem nunca sair do caminho de captura, e ainda aparece no seu feed — marcada como simulada, para você ver exatamente o que foi falseado e confirmar que a regra fez o que esperava. O app vê só uma resposta comum de servidor: respostas sintéticas não carregam nenhum cabeçalho interno ou identificador, então nada na resposta revela a interceptação.

Desligue a regra pela chave de ativação quando terminar. Uma regra desativada não custa nada e mantém seu formato para a próxima vez.

Alguns mocks precisam acontecer uma vez só. O caso clássico é um 401 sintético que faz o app acreditar que o token expirou para ele rodar o fluxo de renovação — responda assim a toda requisição e o app renova, tenta de novo, recebe outro 401 e gira para sempre. O campo Max runs limita quantas vezes uma regra pode disparar; ao atingir o limite ela se desativa sozinha e o editor mostra um selo de autodesativada, diferente de uma regra que você mesmo desligou.

A contagem é por dispositivo e sobrevive a reconexões e reinícios do app, então um limite de um dispara uma única vez naquele celular, não uma vez por sessão. Uma regra global com limite é suprimida só no dispositivo que o gastou e continua disparando em todos os outros celulares da frota. Você também pode pedir ao BusyBro, em linguagem natural, um mock 401 de uma vez só em um host, e ele escreve a mesma regra.

Um corpo Mock é uma string congelada. Quando a resposta precisa depender da requisição — um id devolvido, um timestamp, um campo alterado na resposta real — mude a ação da regra para Script, ou crie um script independente em Settings e depois Scripts. Você tem um editor de código com autocompletar para os objetos de requisição, resposta e auxiliares, e um painel Test que roda seu script contra uma entrada capturada real e mostra um diff de antes e depois sem tocar no tráfego ao vivo. O teste a seco usa o sandbox idêntico ao do proxy ao vivo, então passar no teste significa funcionar em produção.

Um script que lança erro ou estoura o tempo falha aberto: os bytes originais são encaminhados e a entrada é marcada no inspetor, então um script quebrado nunca trava uma conexão nem se revela ao app. Scripts são de nível administrador porque executam código arbitrário no caminho de captura.