Конструктор строки запроса

Конструктор строки запроса помогает вам создавать и проверять ту часть URL-адреса, которая идет после вопросительного знака. Он разработан для разработчиков, маркетологов, аналитиков, QA-тестировщиков и служб поддержки, которым требуются чистые параметры URL для поисковых страниц, вызовов API, перенаправлений, подписанных URL-адресов, UTM-кампаний и тикетов отладки.

Как использовать Конструктор строки запроса

1. Выберите режим Создать, если у вас есть пары ключ-значение, или режим Декодировать, если у вас уже есть строка запроса или URL.
2. В режиме Создать вводите по одной паре ключ-значение на строку. В режиме Декодировать вставьте исходную строку запроса или полный URL.
3. Выберите, должны ли пробелы заменяться знаками плюс или процентным кодированием, а также укажите способ представления повторяющихся ключей.
4. Нажмите «Создать строку запроса» или «Декодировать строку запроса», чтобы сгенерировать закодированный запрос, декодированную таблицу, предупреждения и предварительный просмотр JSON.
5. Скопируйте строку запроса, версию с вопросительным знаком, полный URL-адрес или представление JSON для использования в коде, аналитике, API или перенаправлениях.

Примечания по кодированию

Строки запросов компактны, но даже мелкие нюансы кодирования имеют значение. Пробел может быть записан как + в классическом кодировании форм или как %20 в строгом процентном кодировании. Зарезервированные символы, такие как &, =, ?, #, и символы не из набора ASCII должны подвергаться процентному кодированию, когда они являются данными, а не элементами структуры URL.

Общие сценарии использования

• Создание URL-адресов UTM-кампаний без случайной потери параметров.
• Отладка запросов API, использующих повторяющиеся фильтры, такие как tag=python&tag=web.
• Декодирование URL-адресов перенаправления, областей доступа OAuth, поисковых фильтров и аналитических тегов.
• Сравнение исходной строки запроса с нормализованной строкой перед копированием в код.

FAQ

Что такое строка запроса URL?
Строка запроса URL — это часть URL-адреса после вопросительного знака. Она хранит параметры в виде пар ключ-значение, например q=url+tools&page=2, чтобы браузеры, серверы, API и инструменты аналитики могли передавать небольшие фрагменты состояния.

Следует ли кодировать пробелы как + или %20?
Используйте знаки плюс для классических строк запросов HTML-форм и многих параметров веб-приложений. Используйте %20, когда вам требуется строгое процентное кодирование, подписанные URL-адреса, канонизация API или стиль, более точно соответствующий RFC 3986.

Как обрабатываются повторяющиеся ключи запроса?
Повторяющиеся ключи можно оставить в виде tag=one&tag=two, преобразовать в массивы с квадратными скобками, такие как tag[]=one&tag[]=two, или в индексированные массивы, такие как tag[0]=one&tag[1]=two. Различные серверные фреймворки предпочитают разные соглашения.

Можно ли вставить полный URL-адрес в декодер?
Да. Декодер извлекает часть после первого вопросительного знака, игнорирует фрагмент после # для decoding и показывает нормализованную строку запроса и декодированные параметры.

Отправляет ли этот инструмент запросы на введенный мной URL?
Нет. Инструмент только создает, декодирует и отображает текст. Он не переходит по введенному URL-адресу, не вызывает эндпоинты API и не проверяет, принимает ли удаленный сервер эти параметры.

Почему важны дублирующиеся и пустые параметры запроса?
Дубликаты ключей и пустые значения могут изменить то, как сервер интерпретирует запрос. Некоторые фреймворки превращают дубликаты в массивы, некоторые сохраняют только первое или последнее значение, а некоторые обрабатывают пустые значения иначе, чем отсутствующие параметры.