Папки

Папки группируют запросы в дереве запросов на боковой панели и несут настройки: авторизация, переменные и скрипты, заданные для папки, действуют на каждый запрос внутри неё. На диске папка — это каталог в requests/ с файлом _folder.toml.

Создание папкиCopy Anchor Link

• Файл › Новая папка (⇧⌘N), пока на боковой панели открыты Запросы.
• Кнопка + рядом с Запросы на боковой панели, затем Новая папка.
• Щёлкните папку, удерживая Control, и выберите Новая папка, чтобы создать папку внутри неё, или щёлкните так по пустому месту в дереве, чтобы создать папку на верхнем уровне.

Имя новой папки сразу доступно для правки. Введите имя и нажмите ↩.

Новый запрос в контекстном меню папки создаёт запрос внутри неё. Файл › Новый запрос (⌘N) и остальные команды «Новый … запрос» создают запрос там, где вы находитесь в дереве.

Переименование, дублирование и порядокCopy Anchor Link

Щёлкните запрос или папку, удерживая Control, чтобы открыть меню:

У папок есть также Новый запрос, Новая папка, Настройки папки…, Связать со спецификацией OpenAPI… (или Проверить изменения в спецификации OpenAPI…, когда связь уже есть; см. спецификации), Описать в спецификации OpenAPI… (см. спецификации по трафику) и Экспортировать папку… (см. экспорт).

Заданный вами порядок объектов сохраняется в _folder.toml папки, поэтому он одинаков для всех, кто открывает рабочее пространство.

Перемещение клавиатурой и мышьюCopy Anchor Link

В дереве запросов ↑ и ↓ двигают выделение, → открывает папку, а ← закрывает её или переходит к папке выше.

Перетаскивайте запросы и папки, чтобы переместить их:

• На месте, куда попадёт объект, открывается промежуток, и строки ниже расступаются.
• Под открытой папкой сдвиньте указатель влево или вправо, чтобы выбрать уровень: внутрь папки или после неё.
• Задержитесь на закрытой папке, и она откроется, так что можно бросить объект между её элементами. Папки, открытые таким способом, закрываются снова, если перетаскивание закончилось в другом месте.
• Если перетащить один из нескольких выбранных объектов, переместятся все.

Бросьте файлы из Finder на дерево, чтобы импортировать их в эту папку: Postman, Insomnia, OpenAPI, HAR и другие форматы, которые читает Echolot. Вставьте или бросьте команду cURL, чтобы создать из неё запрос.

Выбор нескольких объектовCopy Anchor Link

⌘-щелчок добавляет объект к выбору или убирает его. ⇧-щелчок выбирает всё между последним объектом и этим. Щёлкните любой из выбранных объектов, удерживая Control, чтобы увидеть, что можно сделать со всеми сразу:

Если выбраны и папка, и объекты внутри неё, команды действуют на папку.

Правка нескольких запросов сразуCopy Anchor Link

Изменить N запросов… открывает лист с тремя вкладками: Заголовки, Параметры и Авторизация. Каждое сделанное там изменение попадает в каждый выбранный запрос, когда вы нажимаете Применить к N запросам.

• В Заголовки и Параметры перечислены все заголовки и параметры, которые есть хотя бы у одного из запросов. Значение, по которому запросы расходятся, показывается как «Разные» и остаётся у каждого как есть, пока вы не введёте новое. Строка, которой нет у части запросов, сообщает, у скольких она есть, и предлагает Добавить во все, чтобы дать её каждому запросу. Удалите строку, чтобы убрать её у каждого запроса.
• В Авторизация есть варианты Оставить у каждого запроса свою, Наследовать от папки, Без авторизации или та же авторизация, что у одного из выбранных запросов (Как у «List orders» (Bearer Token)). Чтобы задать всем новые учётные данные, укажите их у папки и выберите Наследовать от папки.

Всё изменение — один шаг: Правка › Отменить возвращает его для каждого запроса.

Настройки папкиCopy Anchor Link

Щёлкните папку, удерживая Control, и выберите Настройки папки…. В листе такие вкладки:

Нажмите Готово, чтобы сохранить. Если закрыть лист иначе или закрыть окно, правки тоже сохраняются.

В Alpenglow папка Orders задаёт авторизацию Bearer с {{token}}, поэтому каждый запрос в ней отправляет токен, который захватил Auth › Sign in. Запрос со своей авторизацией использует её.

Настройки рабочего пространстваCopy Anchor Link

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

Как запросы наследуютCopy Anchor Link

Для авторизации запрос использует первый из этих уровней, где что-то задано: сам запрос, его папка, папки выше (от ближайшей наружу), затем рабочее пространство.

Переменные, наоборот, складываются: запрос видит переменные всех уровней, а если на двух уровнях есть одно и то же имя, побеждает ближайший. Порядок описан в разделе «Окружения».

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

Заголовки из папок не наследуются; общие заголовки задавайте командой Изменить N запросов… или в скрипте перед запросом.

Перемещение запроса меняет то, что он наследуетCopy Anchor Link

Запрос берёт авторизацию, переменные и скрипты папки, в которой лежит. Переместите его в другую папку, и он возьмёт настройки той папки. Если запрос полагался на авторизацию прежней папки, после перемещения проверьте его вкладку Авторизация.

Удаление папокCopy Anchor Link

Переместить в Корзину… для папки сначала спрашивает и сообщает, сколько запросов в ней лежит. Папка, её настройки и все запросы внутри попадают в Корзину в Finder. Правка › Отменить возвращает их.