Parser Parametrów URL (Query String)

Parsuj query string i dane form-urlencoded do edytowalnych tabel i JSON w przeglądarce z pełną obsługą tablic oraz zagnieżdżonych kluczy.

Bez przesyłania plikówBez rejestracjiNatychmiastowe wyniki
Interaktywny edytor klucz-wartośćTablice i zagnieżdżone nawiasy → JSONx-www-form-urlencoded (+) vs ścisłe %20
Analizuj ciąg zapytania
Silnik offline gotowy100% prywatna praca w przeglądarce • Bez wysyłania do chmury
100% prywatności • Zero wysyłania plików na serwer

Dlaczego warto używać darmowego Parser Parametrów URL (Query String) od Utiliome?

Stworzone od podstaw dla pełnej prywatności i natychmiastowego działania. Bez subskrypcji, opłat i rejestracji.

Dwukierunkowy konwerter Query String i JSON

Parsuj ciągi ?key=value lub ładunki application/x-www-form-urlencoded na czyste obiekty JSON i serializuj zmodyfikowany JSON z powrotem do znormalizowanych parametrów zapytania.

Powtarzające się klucze tablic i zagnieżdżona składnia nawiasowa

Rozpoznaje zduplikowane klucze (?tag=go&tag=rust), jawne nawiasy tablicowe (ids[]=1&ids[]=2) oraz zagnieżdżone hierarchie obiektów (filter[status]=open&page[limit]=50).

Konfigurowalna serializacja spacji (+ vs %20)

Dekoduje na wejściu spacje zapisane jako + oraz %20 zgodnie z regułami URLSearchParams, pozwalając przy eksporcie wybrać ścisłe kodowanie RFC 3986 (%20) lub formularzowe HTML (+).

Interaktywna tabela parametrów bez wysyłania danych

Dodawaj, przełączaj, edytuj lub usuwaj parametry lokalnie w pamięci przeglądarki bez ujawniania kluczy API, tokenów stanu OAuth czy ładunków webhooków zewnętrznym serwerom.

Utiliome kontra tradycyjne narzędzia w chmurze

Porównaj nasz lokalny silnik WebAssembly ze starymi narzędziami chmurowymi.

Funkcja Utiliome (Lokalnie w przeglądarce) Tradycyjne konwertery chmurowe
Dwukierunkowy konwerter Query String i JSON Parsuj ciągi ?key=value lub ładunki application/x-www-form-urlencoded na czyste obiekty JSON i serializuj zmodyfikowany JSON z powrotem do znormalizowanych parametrów zapytania. Ograniczone opcje bez zaawansowanej konfiguracji
Powtarzające się klucze tablic i zagnieżdżona składnia nawiasowa Rozpoznaje zduplikowane klucze (?tag=go&tag=rust), jawne nawiasy tablicowe (ids[]=1&ids[]=2) oraz zagnieżdżone hierarchie obiektów (filter[status]=open&page[limit]=50). Wymaga zewnętrznych narzędzi lub ręcznej obróbki
Prywatność i przetwarzanie danych 100% lokalnie w przeglądarce (zero wysyłania na serwer) Przesyła dane na zewnętrzne serwery w chmurze
Cena i wymóg konta 100% za darmo na zawsze bez rejestracji Wymaga rejestracji konta lub płatnej subskrypcji
Jak to działa

Parser Parametrów URL (Query String) – instrukcja w 3 prostych krokach

Instalacja oprogramowania nie jest wymagana. Wszystko działa w Twojej przeglądarce.

1

Wklej Query String, pełny URL lub JSON

Wprowadź surowy ciąg zapytania ?a=1&b=2, pełny adres URL (parser automatycznie wyodrębnia sekcję search), ciało application/x-www-form-urlencoded lub poprawny obiekt JSON.

2

Edytuj klucze, tablice i opcje kodowania

Modyfikuj zdekodowane nazwy i wartości w interaktywnej tabeli klucz-wartość lub edytorze JSON, włączaj i wyłączaj poszczególne wiersze oraz wybierz tryb kodowania tablic i spacji.

3

Skopiuj przebudowany Query String lub JSON

Skopiuj poprawnie zakodowany ciąg zapytania do poleceń cURL i klientów API lub wyeksportuj ustrukturyzowany dokument JSON bezpośrednio do zestawów testowych i fikstur żądań.

Konwersja złożonych ciągów zapytań i ładunków formularzy do JSON

Szybka odpowiedź: Parser query string dzieli bajty wejściowe na separatorach & przed dekodowaniem, rozdziela każdy token na pierwszym znaku =, dekoduje sekwencje + oraz %XX w UTF-8 i agreguje powtarzające się lub ujęte w nawiasy klucze (tag=a&tag=b, filter[status]=open) w tablice JSON oraz zagnieżdżone obiekty.

Nowoczesne punkty końcowe REST, GraphQL-over-GET oraz webhooki regularnie pakują wielowartościowe tablice, zagnieżdżone obiekty filtrów, kursory Base64 i zakodowane frazy wyszukiwania w pojedynczy ciąg zapytania (query string) lub ciało żądania application/x-www-form-urlencoded. Analizowanie lub ręczne edytowanie takich ładunków jako płaskiego tekstu łatwo prowadzi do uszkodzenia sekwencji ucieczki %26 i niedopasowanych nawiasów.

Rozważmy zapytanie wyszukiwania API łączące białe znaki kodowane znakiem +, powtarzające się klucze, zagnieżdżone filtry nawiasowe, kursor paginacji Base64 z dopełnieniem = zakodowanym procentowo oraz pojedynczy parametr flagi:

?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run

Sparsowanie tego ciągu daje natychmiast czytelną, silnie ustrukturyzowaną reprezentację JSON:

{
  "q": "distributed tracing",
  "tag": [
    "otel",
    "grpc"
  ],
  "filter": {
    "status": "open",
    "priority": "high"
  },
  "cursor": "eyJpZCI6NDIwfQ==",
  "dry_run": ""
}

Dlaczego podział na separatorach musi poprzedzać dekodowanie procentowe

Zwróć uwagę, jak cursor=eyJpZCI6NDIwfQ%3D%3D czysto dekoduje się do "eyJpZCI6NDIwfQ==". Parser najpierw dzieli surowy ciąg na znakach &, następnie rozdziela każdą parę na pierwszym dosłownym znaku =, a dopiero potem dekoduje sekwencje + oraz %XX. Gdyby naiwny skrypt uruchomił decodeURIComponent() na całym ciągu zapytania przed podziałem na & i =, każda wartość parametru zawierająca zakodowany znak ampersand (R%26D -> R&D) rozpadłaby się na dwa błędne parametry.

Ponieważ widok JSON i tabela klucz-wartość są synchronizowane dwukierunkowo, możesz również wkleić obiekt filtru JSON z kodu swojej aplikacji i natychmiast wygenerować poprawnie zakodowany ciąg zapytania gotowy do żądań HTTP.

WHATWG URLSearchParams a RFC 3986 i konwencje tablic w backendzie

Szybka odpowiedź: Standard RFC 3986 traktuje komponent query jako nieustrukturyzowany ciąg, w którym spacje są kodowane jako %20, a + pozostaje znakiem dosłownym, natomiast standard WHATWG application/x-www-form-urlencoded (URLSearchParams) koduje spacje jako + i pozostawia składnię tablic oraz zagnieżdżonych obiektów konwencjom poszczególnych frameworków.

Dwie odrębne specyfikacje regulują ciągi zapytań w sieci, a rozbieżności między nimi odpowiadają za jedne z najczęstszych błędów weryfikacji podpisów i parsowania parametrów w integracjach HTTP.

Algorytm `application/x-www-form-urlencoded` a RFC 3986

Formularze HTML oraz interfejs JavaScript URLSearchParams implementują parser WHATWG application/x-www-form-urlencoded:

  1. Usuń początkowy znak ?, jeśli dane pochodzą z location.search.
  2. Podziel dane wejściowe na bajcie 0x26 (&), ignorując puste sekwencje bajtów wynikające z && lub początkowego &.
  3. Dla każdego fragmentu wykonaj podział na pierwszym bajcie 0x3D (=). Jeśli brak znaku =, cały fragment staje się nazwą, a wartość przyjmuje domyślnie "".
  4. Zamień każdy bajt 0x2B (+) zarówno w nazwie, jak i wartości na 0x20 (spacja ASCII).
  5. Zdekoduj procentowo sekwencje szesnastkowe %XX jako UTF-8, zastępując nieprawidłowe sekwencje bajtów znakiem U+FFFD.

Dla kontrastu RFC 3986 sekcja 3.4 definiuje komponent zapytania URI bez specjalnego traktowania + jako spacji. Ścisłe protokoły podpisów kryptograficznych — w szczególności żądania kanoniczne AWS Signature Version 4 oraz OAuth 2.0 / RFC 5849 — wymagają kodowania spacji jako %20, a znaku + jako %2B. Przygotowując zapytania dla podpisywanych API, przebuduj query string przy użyciu serializacji spacji %20 zamiast +.

Serializacja tablic i obiektów w różnych frameworkach

Ani RFC 3986, ani URLSearchParams nie standaryzują zagnieżdżonych tablic ani obiektów. Ekosystemy backendowe wykształciły cztery główne konwencje:

# 1. Powtarzające się klucze (WHATWG URLSearchParams.getAll, Go net/url, Python parse_qs, Java Servlet)
?tag=otel&tag=grpc

# 2. Nieindeksowane nawiasy (PHP $_GET, Ruby on Rails / Rack, Express qs)
?tag[]=otel&tag[]=grpc

# 3. Indeksowane nawiasy (uporządkowane tablice w Node.js qs)
?tag[0]=otel&tag[1]=grpc

# 4. Zagnieżdżone klucze obiektów (Node.js qs, Rails, PHP, Stripe REST API)
?filter[status]=open&filter[created][gte]=1730000000

Przed serializacją warto wiedzieć, czego oczekuje docelowy serwer: wysłanie tag=otel&tag=grpc do standardowej tablicy PHP $_GET['tag'] nadpisze pierwszą wartość i zwróci skalar "grpc", chyba że zostaną użyte nawiasy tag[], podczas gdy r.URL.Query()["tag"] w języku Go oczekuje kluczy tag bez nawiasów.

Aspekty bezpieczeństwa: HTTP Parameter Pollution i Prototype Pollution

  • HTTP Parameter Pollution (HPP): Gdy docierają zduplikowane klucze skalarne (?account=user_1&account=user_2), środowiska uruchomieniowe serwerów rozwiązują kolizję niespójnie: Python urllib.parse.parse_qs oraz Go Values.Get() odczytują pierwszą wartość, PHP i Ruby Rack odczytują ostatnią wartość, a Node/Express tworzy tablicę (["user_1", "user_2"]). Jeśli brama API sprawdza uprawnienia względem pierwszego wystąpienia, podczas gdy mikroserwis docelowy przetwarza ostatnie wystąpienie, kontrola autoryzacji może zostać ominięta.
  • Prototype Pollution w parserach nawiasowych: Naiwne parsery nawiasowe w JavaScript, które przypisują obj[key1][key2] = val bezpośrednio na Object.prototype, są podatne na ładunki takie jak ?__proto__[isAdmin]=true lub ?constructor[prototype][isAdmin]=true. Bezpieczne parsery tworzą słowniki za pomocą Object.create(null), blokują zarezerwowane klucze prototypów i egzekwują limity głębokości zagnieżdżenia.

Parser Parametrów URL a Parser Składników URL i Koder URL: Którego narzędzia potrzebujesz?

Szybka odpowiedź: Użyj Parsera Parametrów URL (Query String) do interaktywnej edycji parametrów, parsowania tablic/nawiasów i dwukierunkowej konwersji JSON. Użyj Parsera Składników URL, gdy musisz podzielić lub edytować schemat, host, port, segmenty ścieżki i hash, albo Kodera i dekodera URL do kodowania pojedynczych surowych ciągów.

Każde narzędzie z grupy URL w Utiliome obsługuje odrębny zakres zadań, zapewniając dedykowane funkcje bez zbędnego przeładowania interfejsem:

Funkcja Parser Parametrów URL (To narzędzie) Parser Składników URL Koder i dekoder URL Koder procentowy (Percent Encoder)
Główny cel Parametry query, ciała formularzy i synchronizacja JSON Pełna anatomia URI (RFC 3986 / WHATWG) Kodowanie i dekodowanie surowych ciągów Ścisłe kodowanie bajtowe %XX wg RFC 3986
Dwukierunkowa konwersja JSON Pełne wsparcie (zagnieżdżone obiekty i tablice) Eksport pól URI do JSON tylko do odczytu Nie dotyczy Nie dotyczy
Składnia tablic i nawiasów (a[]=1, f[k]=v) Natywne parsowanie i konfigurowalna przebudowa Płaskie wyświetlanie par zapytania Nie dotyczy Nie dotyczy
Przełącznik serializacji spacji + vs %20 Konfigurowalny na wyjściu Standardowa normalizacja komponentów URI Tryby komponentu (%20) i formularza (+) Wyłącznie ścisłe %20
Edycja schematu, hosta, portu, TLD i ścieżki Automatycznie odrzuca części URL spoza query Pełny edytor i rekonstruktor składników Brak parsowania strukturalnego Brak parsowania strukturalnego

Wybór odpowiedniego przepływu pracy

  • Inspekcja lub modyfikacja schematu, subdomeny, TLD, portu, segmentów ścieżki lub fragmentu: Przełącz się na Parser Składników URL, aby wyświetlić i zrekonstruować cały adres URL z uwzględnieniem wszystkich granic RFC 3986.
  • Kodowanie pojedynczej surowej wartości zawierającej znaki zarezerwowane (&, =, +, /): Użyj narzędzia Koder i dekoder URL, aby czysto zakodować lub zdekodować pojedyncze ciągi tekstowe.
  • Generowanie ścisłych kanonicznych sekwencji ucieczki RFC 3986 (!, ', (, ), * -> %XX): Wybierz Koder procentowy (Percent Encoder) podczas budowania kanonicznych wartości zapytań dla OAuth 1.0a lub AWS SigV4.
FAQ

Parser Parametrów URL (Query String) – FAQ i przewodnik techniczny

Wszystko, co musisz wiedzieć o darmowym narzędziu online parser query string od Utiliome.

Dlaczego dosłowny znak plusa (+) w parametrze URL dekoduje się jako spacja?

Zgodnie ze standardem application/x-www-form-urlencoded oraz przeglądarkowym URLSearchParams, bajt 0x2B (+) reprezentuje zakodowaną spację (0x20). Jeśli wartość parametru zawiera dosłowny znak plusa — na przykład przesunięcie strefy czasowej ISO 8601 (2026-11-01T09:30:00+01:00), token Base64 lub numer telefonu E.164 (+14155550100) — musi on zostać przesłany jako %2B. Surowe ciągi tekstowe możesz wcześniej zabezpieczyć w narzędziu Koder i dekoder URL.

Jak powtarzające się klucze, np. ?tag=api&tag=cli, są reprezentowane po konwersji do JSON?

Ponieważ obiekty JSON zgodne z RFC 8259 wymagają unikalnych kluczy na każdym poziomie, zduplikowane nazwy parametrów są grupowane w kolejności występowania w tablicę JSON: { "tag": ["api", "cli"] }. Konwertując tę tablicę JSON z powrotem na query string, możesz zapisać ją jako powtarzające się klucze (tag=api&tag=cli), puste nawiasy (tag[]=api&tag[]=cli) lub indeksowane nawiasy (tag[0]=api&tag[1]=cli).

Czy mogę wkleić bezpośrednio pełny adres URL lub ciało żądania POST application/x-www-form-urlencoded?

Tak. Gdy wkleisz pełny adres URL, np. https://api.example.com/v2/events?limit=25&cursor=abc#section, parser automatycznie wyodrębni podciąg zapytania znajdujący się między ? a # (limit=25&cursor=abc). Surowe ciała żądań application/x-www-form-urlencoded bez początkowego znaku ? są parsowane identycznie. Jeśli musisz również edytować nazwę hosta, port, segmenty ścieżki lub hash, otwórz adres w narzędziu Parser Składników URL.

Co dzieje się z parametrami flag bez znaku równości, takimi jak ?debug lub ?dry_run?

Zgodnie z algorytmem parsowania WHATWG URLSearchParams, fragment parametru bez znaku = ustawia zdekodowany klucz parametru na nazwę fragmentu ("dry_run"), a jego wartość na pusty ciąg (""). W interaktywnej tabeli możesz przypisać jawną wartość, np. true, usunąć parametr lub pozostawić go pustym.

Czy klucze API, tokeny OAuth lub parametry webhooków są wysyłane na jakikolwiek serwer backendowy?

Nie. Parsowanie, edycja w tabeli oraz serializacja JSON działają w 100% lokalnie w Twojej przeglądarce przy użyciu kodu JavaScript po stronie klienta. Wrażliwe dane uwierzytelniające z zapytań, wartości access_token ani wewnętrzne ładunki analityczne nigdy nie opuszczają Twojego urządzenia.