Klient / tester REST API

Sestavte a odešlete požadavky HTTP s parametry dotazu, hlavičkami, těly JSON / formulářů a autentizací Basic nebo Bearer a prohlédněte si stav, časování a formátované odpovědi JSON. Importujte stávající příkaz cURL nebo zkopírujte aktuální požadavek zpět jako cURL. Raději sestavujete znovupoužitelné požadavky krok za krokem? Použijte Tvůrce požadavků HTTP. Viz také rodina nástrojů pro API.
Veškeré zpracování probíhá lokálně ve vašem prohlížeči. Požadavky mezi zdroji podléhají politice CORS cílového serveru — pokud požadavek selže, viz poznámku níže.
Vložte příkaz cURL
Parametry dotazu
Hlavičky
Tělo
Autorizace
Možnosti
Po vyplnění se URL požadavku připojí k této předponě. Užitečné pro servery blokované CORS.
200
Tělo Hlavičky

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
Proč může požadavek selhat: prohlížeče blokují čtení mezi zdroji, pokud API nevrací Access-Control-Allow-Origin. Pokud cíl CORS nepovoluje, můžete spustit vlastní proxy CORS a vložit její URL do předpony proxy výše, nebo použít převodník cURL a spustit požadavek z terminálu. Těla požadavků pro GET/HEAD se ignorují; nástroj pro WebSocket je samostatně v Testeru WebSocket.


                                                            

                                                                Metody HTTP vysvětleny
                                                                
Metoda, kterou zvolíte, sdělí serveru, co chcete s URL udělat. Zde je význam každého ze sedmi sloves, která tento nástroj může odeslat:

                                                                
GET — Načte zdroj: webovou stránku, obrázek, seznam záznamů. „Dej mi to, co je na této URL.“ Je jen pro čtení a bezpečné opakovat; obvykle nenese tělo požadavku (tělo u požadavku GET, pokud je, se ignoruje).

                                                                
POST — Odešle nová data na server, obvykle k vytvoření zdroje nebo spuštění akce — odeslání formuláře, nahrání souboru, spuštění úlohy. Data putují v těle požadavku. POST není idempotentní: odeslání stejného POST dvakrát může vytvořit dva záznamy.

                                                                
PUT — Nahradí celý zdroj na URL tím, co pošlete. Tělo musí nést úplnou novou verzi zdroje. PUT je idempotentní: opakování stejného požadavku má stejný účinek jako jeho jednorázové odeslání.

                                                                
PATCH — Změní pouze část zdroje. Pošlete jen pole, která chcete aktualizovat, např. {"email": "new@example.com"}, místo celého záznamu. Zvolte PATCH, když by plný PUT vynutil znovu odeslat pole, kterých se nedotýkáte.

                                                                
DELETE — Odstraní zdroj na dané URL. DELETE je idempotentní: smazání něčeho, co už zmizelo, vrátí stejný výsledek (obvykle 404) a nic dalšího se neudělá.

                                                                
HEAD — Stejné jako GET, ale odpověď obsahuje pouze hlavičky — tělo se vůbec neposílá zpět. HEAD použijte ke zjištění, zda URL existuje, jak velký je soubor (Content-Length), kdy byl naposledy změněn (Last-Modified) nebo jakého je typu (Content-Type), aniž byste stahovali celý obsah.

                                                                
OPTIONS — Zeptá se serveru, jaké metody a možnosti jsou pro URL povoleny, nebo spustí kontrolu CORS preflight. Hlavičky odpovědi, například Access-Control-Allow-Methods, vypisují, co je povoleno. OPTIONS obvykle nenese tělo; prohlížeče jej často posílají automaticky před požadavky POST/PUT/PATCH/DELETE mezi zdroji.

                                                                
Snadno se pletou: HEAD vs GET — požadavek je stejný, ale HEAD nevrací tělo. PUT vs PATCH — PUT nahradí celý zdroj; PATCH použije částečnou aktualizaci pouze těch polí, která pošlete.