Ugrás a tartalomhoz
100% helyi

URI sablon bővítő

RFC 6570 URI sablonok kiterjesztése valódi URL-ekre a megadott változók felhasználásával.

Bemenet
Változók
Kimenet

URI sablon bővítő

Illessz be egy URI sablont — az OpenAPI/Swagger hivatkozás-definícióban, OAuth átirányítási URI-kban, webhook konfigurációkban és hipermédias API-kban (HAL, Hydra, JSON:API) használt fajta — és ez az eszköz kiterjeszti annak {kifejezéseit} valódi URL-re. Az RFC 6570 teljes mértékben megvalósítja, beleértve az útvonal-, lekérdezési karakterlánc-, útvonal-paraméter-, címke- és fragment-operátorokat is, így egy sablon, mint "/users/{id}{?fields,tags*}" pontosan úgy bővül, ahogy egy kompatibilis kliens-függvénytár tenné.

A változó értékek a második panelben szerepelnek, egy "key=value" soronként. Az egyszerű érték egy karakterlánc; listához egy vesszővel elválasztott listát szögletes zárójelek közé kell helyezni ("tags=[dev,admin]") a lista-változóknál, és kapcsos zárójeleket kell használni "|" elválasztott párokkal ("keys={role=admin|team=core}") az asszociatív (kulcs-érték) változóknál. A sablon szintje (1-4) ellenőrzi, hogy mely RFC 6570 funkciók szükségesek egy kifejezéshez, és megjelöli azokat, amelyek meghaladják a választott szintet — hasznos, ha egy alacsonyabb szintet csak megvalósító klienshez szeretnél igazodni. Az "Fenntartott karakterek kódolása" opció szigorú kódolást kényszerít még a normálisan megengedő "+" és "#" kiterjesztéseken belül is; az "Üres változók kihagyása" opció eldobja a helyére egy üres karakterláncra mutató változót, hogy ne hagyjon üres paramétert.

A kibővített URL alatt az eszköz mindig felsorolja azokat a változókat, amelyekre a sablon hivatkozott, de nem adták meg őket ("missing"), valamint azokat, amelyeket megadtak, de a sablon soha nem használt ("unused") — ez a leggyorsabb módja egy-egy gépelési hiba felismerésének a sablonban vagy a változó listában. A sortöréspreferenciák, előtag-módosítók ("{var:3}") és kiterjesztési módosítók ("{list*}", "{keys*}") mind a specifikáció szerint kezelhetők, és egy hibás sablon (kiegyensúlyozatlan zárójelek, üres kifejezés, nem támogatott operátor) egyszerű, szöveges hibaüzenetet ad vissza az üres eredmény helyett.

Minden feldolgozás helyileg történik a böngészödben — a sablon és annak változói soha nem kerülnek feltöltésre sehova. Másolja ki a kibővített URL-t, töltse le .txt fájlként, vagy küldje közvetlenül egy másik eszköz bemenetébe a munka folytatásához.

Gyakori kérdések

Mi az URI sablon?
Az URI sablon (RFC 6570) egy URL minta {helyőrzőkkel}, amely valódi értékekre helyettesítve — az a formátum, amelyet az API-k dokumentált paraméteres végpontok leírására használnak, például "/users/{id}".
Mely operátorok támogatottak?
Mindegyik: egyszerű kiterjesztés, "+" (fenntartott karakterek megengedett), "#" (fragment), "." (címke), "/" (útvonal szegmensek), ";" (útvonal-stílus paraméterek), "?" (lekérdezési karakterlánc) és "&" (lekérdezési folytatás).
Hogyan adhatok meg listát vagy objektumot változó értékként?
Egy listát szögletes zárójelek közé helyezz, pl. "tags=[dev,admin]". Egy objektumot kapcsos zárójelek közé helyezz "|" elválasztott párokkal, pl. "keys={role=admin|team=core}" — az egyszerű érték egyszerű karakterlánc marad.
Mi történik, ha egy sablonban használt változónak nincs értéke?
Üres értékként kiterjesztésre kerül, és az eredmény alatt "Missing" alatt szerepel, így azonnal láthatod, mely értékeket kell még megadnod.
Fel van-e töltve az URI sablonos vagy változó adat valahova?
Nem. A kiterjesztés teljes egészében a böngészödben futtatódik — a sablon és annak változói soha nem hagyják el az eszközödet.