JSON у рядок запиту
Створюйте рядок запиту URL з об’єкта JSON. Кожне значення кодується відсотковим кодуванням, для вкладених об’єктів використовується нотація з дужками, як-от filter[status]=open, а масиви записуються як повторювані ключі, ключі з дужками, з індексами або списки, розділені комами. Виберіть %20 або + для пробілів відповідно до сервера, який зчитує URL.
Поширені запитання
Які формати масивів доступні?
Формат повторення записує ids=1&ids=2, формат дужок — ids[]=1&ids[]=2, формат індексів — ids[0]=1&ids[1]=2, а формат ком — ids=1,2. 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=.