Подмена ответа API на реальном устройстве

Откройте ленту дашборда и найдите реальный запрос к эндпоинту. Если в его строке видно расшифрованное тело — вы готовы. Если хост всё ещё показан зашифрованным, добавьте его в список SSL proxy устройства — через действия с хостом в строке или в настройках устройства — и вызовите запрос снова. У хоста, проходящего зашифрованным, движок может сопоставить только имя хоста; путь невидим, поэтому точная по пути подмена никогда не сработает.

Откройте страницу Blocks из навигации настроек для глобального правила или перейдите к устройству, затем в Blocks — для правила только для этого телефона. Добавьте правило и укажите метод — или оставьте пустым, чтобы совпадал любой — и шаблон. Шаблоны — те же маски хост-плюс-путь, что и у точек останова: хост, косая черта, путь, со звёздочкой там, где сегмент меняется.

Установите действие Mock. Если Block нужен, чтобы вызов провалился, а Drop делает вид, что сеть пропала, то Mock призван его удовлетворить: задайте статус — по умолчанию 200, — заголовки, на которые смотрит приложение, и тело. Укажите тот Content-Type, который разбирает ваше приложение; JSON-клиент, получивший текстовый ответ, упадёт, не прочитав ни байта. В виде JSON правило выглядит так.

Сохраните правило и воспользуйтесь приложением. Следующий совпавший запрос получает ответ, не покидая путь перехвата, и всё равно появляется в вашей ленте — с пометкой о подмене, так что вы точно видите, что было подделано, и убеждаетесь, что правило сделало ожидаемое. Приложение видит лишь обычный ответ сервера: синтетические ответы не несут внутренних или опознавательных заголовков, так что ничто в ответе не выдаёт перехват.

Когда закончите, выключите правило его переключателем. Отключённое правило ничего не стоит и сохраняет форму до следующего раза.

Некоторые подмены должны случаться один раз. Классика — синтетический 401, заставляющий приложение поверить, что токен истёк, и запустить обновление; ответьте так на каждый запрос — и приложение обновит токен, повторит, снова получит 401 и закрутится навечно. Поле Max runs ограничивает, сколько раз правило может сработать; по достижении лимита оно отключает себя, и редактор показывает бейдж автоотключения, отличный от правила, выключенного вами вручную.

Счётчик ведётся для каждого устройства и переживает переподключения и перезапуски приложения, так что лимит в единицу срабатывает один раз вообще на этом телефоне, а не раз за сессию. Глобальное правило с лимитом подавляется только на устройстве, которое его исчерпало, и продолжает срабатывать на всех остальных телефонах парка. Можно также попросить BusyBro обычным языком об одноразовой подмене 401 для хоста — он напишет то же правило.

Тело Mock — одна замороженная строка. Когда ответ должен зависеть от запроса — возвращённый id, метка времени, поле, вписанное в реальный ответ, — переключите действие правила на Script или создайте отдельный скрипт в Settings, затем Scripts. Вы получаете редактор кода с автодополнением для объектов запроса, ответа и помощников и панель Test, которая прогоняет скрипт на реальной перехваченной записи и показывает diff «до и после», не трогая живой трафик. Сухой прогон использует ту же песочницу, что и живой прокси, так что пройденный тест означает, что скрипт работает вживую.

Скрипт, бросивший исключение или превысивший таймаут, отказывает в открытую: исходные байты пересылаются, а запись помечается в инспекторе, поэтому сломанный скрипт никогда не подвесит соединение и не выдаст себя приложению. Скрипты — админский уровень, потому что выполняют произвольный код в пути перехвата.