JSON в строку запроса
Создайте строку запроса URL из объекта JSON. Каждое значение кодируется через проценты, во вложенных объектах используются квадратные скобки, например filter[status]=open, а массивы записываются повторяющимися ключами, с квадратными скобками, индексами или через запятую. Выберите %20 или + для пробелов, чтобы соответствовать серверу, который читает URL.
Часто задаваемые вопросы
Какие форматы массивов доступны?
Вариант Repeat записывает ids=1&ids=2, brackets — ids[]=1&ids[]=2, indices — ids[0]=1&ids[1]=2, а comma — ids=1,2. Вариант Repeat используют URLSearchParams и большинство клиентов HTTP; PHP и Rails ожидают квадратные скобки или индексы.
Как записываются вложенные объекты?
С помощью скобочной нотации: {"filter": {"status": "open"}} превращается в filter[status]=open. Для более глубоко вложенных объектов добавляются скобки, например a[b][c]=1.
Пробелы обозначаются как %20 или +?
В строке запроса оба варианта обозначают пробел. %20 подходит для любой части URL, а + отправляют формы HTML. Большинство серверов принимают оба варианта, поэтому используйте тот, который указан в документации сервера или API.
Почему скобки кодируются как %5B и %5D?
Квадратные скобки — зарезервированные символы в URL, поэтому по умолчанию они кодируются в процентах, как это делают http_build_query в PHP и библиотека qs. Включите отображение скобок без кодирования, чтобы сохранить их в виде [ и ]; большинство серверов принимает и такой вариант.
Какие символы не кодируются?
Буквы, цифры и символы - _ . ! ~ * ' ( ) остаются без изменений. Все остальное, включая &, =, # и буквы не из ASCII, кодируется в процентах с использованием UTF-8.
Как записываются значения null и логические значения?
Значения true, false и числа записываются как текст, например active=true. Значение null становится пустым значением, например note=.