Simula una risposta API su un dispositivo reale

Apri il feed della dashboard e trova una richiesta reale verso l'endpoint. Se la sua riga mostra un body decifrato, sei pronto. Se l'host risulta ancora cifrato, aggiungilo alla lista SSL proxy del dispositivo — dalle azioni host della riga o nelle impostazioni del dispositivo — e riattiva la chiamata. Su un host che passa cifrato il motore può corrispondere solo sul nome host; il percorso è invisibile, quindi un mock preciso sul percorso non scatta mai.

Apri la pagina Blocks dal menu delle impostazioni per una regola globale, oppure vai sul dispositivo e poi su Blocks per una regola valida solo per questo telefono. Aggiungi una regola e compila il metodo — o lascialo vuoto per corrispondere a qualsiasi — e il pattern. I pattern sono gli stessi caratteri jolly host più percorso usati dai breakpoint: l'host, una barra, il percorso, con un asterisco dove un segmento varia.

Imposta l'azione su Mock. Dove Block serve a far fallire una chiamata e Drop fa sembrare che la rete sia sparita, Mock serve a soddisfarla: imposta lo stato — il predefinito è 200 —, gli header che l'app guarderà e il body. Dagli il Content-Type che la tua app interpreta; un client JSON che riceve una risposta di testo fallisce prima di leggere un byte. Salvata come JSON, la regola appare così.

Salva la regola e usa l'app. La prossima richiesta corrispondente riceve risposta senza mai lasciare il percorso di cattura, e compare comunque nel tuo feed — contrassegnata come simulata, così vedi esattamente cosa è stato falsificato e confermi che la regola ha fatto ciò che ti aspettavi. L'app vede solo una normale risposta del server: le risposte sintetiche non portano alcun header interno o identificativo, quindi nulla nella risposta rivela l'intercettazione.

Disattiva la regola con il suo interruttore quando hai finito. Una regola disattivata non costa nulla e mantiene la sua forma per la prossima volta.

Alcuni mock devono avvenire una volta sola. Il caso classico è un 401 sintetico che fa credere all'app che il token sia scaduto, così avvia il flusso di refresh — rispondi così a ogni richiesta e l'app aggiorna, riprova, riceve un altro 401 e gira all'infinito. Il campo Max runs limita quante volte una regola può scattare; raggiunto il limite si disattiva da sola e l'editor mostra un badge di autodisattivazione, distinto da una regola che hai spento tu.

Il conteggio è per dispositivo e sopravvive a riconnessioni e riavvii dell'app, quindi un limite di uno scatta una sola volta in assoluto su quel telefono, non una volta per sessione. Una regola globale con limite viene sospesa solo sul dispositivo che lo ha esaurito e continua a scattare su ogni altro telefono della flotta. Puoi anche chiedere a BusyBro in linguaggio naturale un mock 401 una tantum su un host, e scriverà la stessa regola.

Un body Mock è una stringa congelata. Quando la risposta deve dipendere dalla richiesta — un id restituito, un timestamp, un campo modificato nella risposta reale — cambia l'azione della regola in Script, oppure crea uno script autonomo in Settings e poi Scripts. Hai un editor di codice con completamento automatico per gli oggetti richiesta, risposta e helper, e un pannello Test che esegue lo script su una voce catturata reale e mostra un diff prima-dopo senza toccare il traffico live. La prova a secco usa la stessa sandbox del proxy live, quindi superare il test significa che funziona dal vivo.

Uno script che genera un errore o va in timeout fallisce in modo aperto: i byte originali vengono inoltrati e la voce viene contrassegnata nell'inspector, così uno script rotto non può mai bloccare una connessione né rivelarsi all'app. Gli script sono di livello amministratore perché eseguono codice arbitrario nel percorso di cattura.