Generator Ciągów Zapytania

Narzędzie Generator ciągów zapytania (Query String Builder) pomaga tworzyć i sprawdzać część adresu URL, która następuje po znaku zapytania. Zostało stworzone z myślą o programistach, marketerach, analitykach, testerach QA i zespołach wsparcia technicznego, którzy potrzebują poprawnych parametrów URL dla stron wyszukiwania, wywołań API, przekierowań, podpisanych adresów URL, kampanii UTM oraz zgłoszeń błędów.

Jak korzystać z Generatora ciągów zapytania

1. Wybierz tryb Buduj, gdy dysponujesz parami klucz-wartość, lub tryb Dekoduj, jeśli masz już gotowy ciąg zapytania bądź adres URL.
2. W trybie Buduj wprowadź jedną parę klucz-wartość na wiersz. W trybie Dekoduj wklej surowy ciąg zapytania lub pełny adres URL.
3. Wybierz, czy spacje mają być zamieniane na znaki plus, czy na spacje kodowane procentowo, oraz określ sposób reprezentacji powtarzających się kluczy.
4. Kliknij przycisk Buduj ciąg zapytania lub Dekoduj ciąg zapytania, aby wygenerować zakodowane zapytanie, czytelną tabelę parametrów, ostrzeżenia oraz podgląd struktury JSON.
5. Skopiuj uzyskany ciąg zapytania, wersję rozpoczynającą się od znaku zapytania, pełny adres URL lub reprezentację w formacie JSON do wykorzystania w kodzie, analityce, interfejsach API lub przekierowaniach.

Uwagi dotyczące kodowania

Ciągi zapytań mają zwartą strukturę, jednak drobne różnice w kodowaniu mają duże znaczenie. Spacja może być zapisana jako + w klasycznym kodowaniu formularzy lub jako %20 w ścisłym kodowaniu procentowym. Znaki zarezerwowane, takie jak &, =, ?, #, oraz znaki spoza zestawu ASCII powinny zostać zakodowane procentowo, gdy stanowią treść danych, a nie element struktury adresu URL.

Typowe zastosowania

• Tworzenie adresów URL kampanii UTM bez ryzyka przypadkowego pominięcia parametru.
• Debugowanie żądań API wykorzystujących powtarzające się filtry, np. tag=python&tag=web.
• Dekodowanie adresów URL przekierowań, zakresów OAuth, filtrów wyszukiwania oraz tagów analitycznych.
• Porównywanie surowego ciągu zapytania ze znormalizowanym ciągiem zapytania przed wklejeniem go do kodu źródłowego aplikacji.

FAQ

Co to jest ciąg zapytania URL?
Ciąg zapytania URL to część adresu URL znajdująca się po znaku zapytania. Przechowuje parametry jako pary klucz-wartość, takie jak q=url+tools&page=2, dzięki czemu przeglądarki, serwery, interfejsy API i narzędzia analityczne mogą przekazywać małe fragmenty stanu.

Czy spacje powinny być kodowane jako + czy %20?
Używaj znaków plus dla klasycznych ciągów zapytania formularzy HTML i wielu parametrów aplikacji internetowych. Użyj %20, gdy potrzebujesz ścisłego kodowania procentowego, podpisanych adresów URL, kanonizacji API lub stylu, który dokładniej odpowiada normie RFC 3986.

Jak są obsługiwane powtarzające się klucze zapytania?
Powtarzające się klucze mogą być zachowane jako tag=one&tag=two, przekonwertowane na tablice z nawiasami, takie jak tag[]=one&tag[]=two, lub przekonwertowane na tablice indeksowane, takie jak tag[0]=one&tag[1]=two. Różne platformy programistyczne preferują różne konwencje.

Czy mogę wkleić pełny adres URL do dekodera?
Tak. Dekoder wyodrębnia część po pierwszym znaku zapytania, ignoruje fragment po znaku # do dekodowania i pokazuje znormalizowany ciąg zapytania oraz zdekodowane parametry.

Czy to narzędzie wysyła żądania do wprowadzonego adresu URL?
Nie. Narzędzie zajmuje się wyłącznie budowaniem, dekodowaniem i wyświetlaniem tekstu. Nie odwiedza wprowadzonego adresu URL, nie wywołuje punktów końcowych API ani nie sprawdza, czy zdalny serwer akceptuje te parametry.

Dlaczego zduplikowane i puste parametry zapytania mają znaczenie?
Zduplikowane klucze i puste wartości mogą zmienić sposób, w jaki serwer interpretuje żądanie. Niektóre platformy zamieniają duplikaty w tablice, niektóre zachowują tylko pierwszą lub ostatnią wartość, a niektóre traktują puste wartości inaczej niż brakujące parametry.