Sestavte HTTP požadavek krok za krokem — proměnné v cestě jako
{userId}, parametry dotazu, hlavičky, těla JSON / formulářů a ověřování — a vygenerujte kód připravený ke spuštění pro
cURL,
Node.js fetch,
Python requests nebo
PowerShell. Tento nástroj slouží k
navrhování a generování; chcete-li požadavek skutečně odeslat a prohlédnout si živou odpověď, předejte jej tlačítkem
Otestovat požadavek → (otevře
klienta REST API / tester), nebo převeďte vložený cURL pomocí
převodníku příkazů cURL.
Vše se sestavuje lokálně ve vašem prohlížeči. Z této stránky se nikdy neodesílá žádný požadavek.
Tipy: obalte segment URL do složených závorek (
{userId}), abyste jej spravovali jako parametr cesty; vygenerovaný kód se obnoví při každé úpravě. Požadavky GET/HEAD ignorují tělo. Vygenerované nahrávání souborů používá v cURL zápis ve stylu
@file, v jiných jazycích zástupné hodnoty — skutečné soubory připojte ve svém kódu. Odesílání mezi původy řeší
klient REST API (dodržujte zásady CORS serveru); k zpětnému převodu existujícího příkazu použijte
převodník příkazů cURL.
Metody HTTP vysvětleny
Když zvolíte metodu, vygenerovaný kód cURL / Node / Python / PowerShell se přizpůsobí. Co každé sloveso znamená pro požadavek, který sestavujete:
GET — získá reprezentaci zdroje. Nemělo by měnit stav serveru a vygenerovaný požadavek obvykle nemá tělo. Použijte GET pro čtení, vyhledávání a koncové body seznamů.
POST — odešle data k vytvoření nového zdroje nebo ke spuštění akce. Tělo se v generovaném kódu stane užitečným obsahem (--data-raw v cURL, argument těla v Node/Python atd.). POST není idempotentní: odeslání dvakrát může vytvořit dva zdroje.
PUT — zcela nahradí existující zdroj. Pošlete celý objekt v těle; vynechaná pole mohou být považována za prázdná. Vygenerovaný kód odešle celé tělo na přesnou URL.
PATCH — aktualizuje jen pole, která uvedete. Tělo nese částečnou sadu změn, takže vygenerované požadavky jsou menší než u PUT, když upravujete jednu nebo dvě hodnoty.
DELETE — odstraní zdroj na dané URL. Je idempotentní a obvykle nemá tělo, takže vygenerovaný kód je jednoduché volání delete jen s hlavičkami.
HEAD — požádá jen o hlavičky, bez těla odpovědi. Vygenerovaný kód vypadá jako GET, ale vrací metadata jako Content-Length, Last-Modified nebo Content-Type, a šetří tak přenos.
OPTIONS — zjistí, co server pro danou URL povoluje, nebo simuluje preflight CORS. Hlavičky odpovědi (například Access-Control-Allow-Methods) ukazují povolená slovesa. OPTIONS obvykle nemá tělo požadavku.
Snadno se pletou: HEAD vs GET — vygenerované požadavky jsou podobné, ale HEAD nevrací tělo. PUT vs PATCH — PUT přepíše celý zdroj; PATCH mění jen pole, která zadáte.
