Klient / tester REST API

Zostavenie a odoslanie požiadaviek HTTP s parametrami dopytu, hlavičkami, telami JSON / formulára a autentifikáciou Basic alebo Bearer, potom kontrola stavu, času a formátovaných odpovedí JSON. Existujúci príkaz cURL sa dá importovať, alebo aktuálna požiadavka kopírovať späť ako cURL. Ak sa požiadavky dajú zostavovať a znovu používať krok za krokom, slúži na to Stavebník požiadaviek HTTP$1Súvisiace: aj rodinu Nástroje pre API.
Všetko beží lokálne v prehliadači. Požiadavky medzi pôvodmi podliehajú pravidlám CORS cieľového servera — ak požiadavka zlyhá, poznámka nižšie.
Vloží sa príkaz cURL
Parametre dopytu
Hlavičky
Telo
Autorizácia
Voľby
Keď je vyplnené, URL požiadavky sa pripojí k tejto predpone. Hodí sa na servery blokované CORS.
200
Telo Hlavičky

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
Prečo požiadavka môže zlyhať: prehliadače blokujú čítanie medzi pôvodmi, pokiaľ API nevráti Access-Control-Allow-Origin. Ak cieľ CORS nepovoľuje, dá sa spustiť vlastný proxy CORS a jeho URL vložiť do predpony proxy vyššie, alebo použiť konvertor cURL a požiadavku spustiť z terminálu.
                                                                Telá požiadaviek pre GET/HEAD sa ignorujú a nástroj WebSocket je samostatne na stránke Tester WebSocket.


                                                            

                                                                Metódy HTTP vysvetlené
                                                                
Zvolená metóda povie serveru, čo sa má s URL urobiť. Takto sa chápe každé zo siedmich slovies, ktoré tento nástroj môže odoslať:

                                                                
GET — Načíta zdroj: webovú stránku, obrázok, zoznam záznamov. „Daj mi to, čo je na tejto URL.“ Je len na čítanie, bezpečne sa dá zopakovať a zvyčajne nenesie telo požiadavky (telo pri GET, ak nejaké je, sa ignoruje).

                                                                
POST — Odošle nové údaje na server, zvyčajne na vytvorenie zdroja alebo spustenie akcie — odoslanie formulára, nahratie súboru, spustenie úlohy. Údaje putujú v tele požiadavky. POST nie je idempotentná: odoslanie rovnakého POST dvakrát môže vytvoriť dva záznamy.

                                                                
PUT — Nahradí celý zdroj na URL odoslaným obsahom. Telo musí niesť úplnú novú verziu zdroja. PUT je idempotentná: opakovanie rovnakej požiadavky má rovnaký účinok ako jej jednorazové odoslanie.

                                                                
PATCH — Mení len časť zdroja. Odosiela sa len pole, ktoré sa má aktualizovať, napr. {"email": "new@example.com"}, namiesto celého záznamu. PATCH sa zvolí vtedy, keď by úplný PUT nútil znovu posielať polia, ktorých sa netýka.

                                                                
DELETE — Odstráni zdroj na URL. DELETE je idempotentná: vymazanie niečoho, čo už neexistuje, vráti rovnaký výsledok (zvyčajne 404) a nič nerobí dvakrát.

                                                                
HEAD — Rovnako ako GET, no odpoveď obsahuje len hlavičky — telo sa vôbec nevracia. HEAD sa používa na zistenie, či URL existuje, aká veľká je súbor (Content-Length), kedy bol naposledy upravený (Last-Modified) alebo aký má typ (Content-Type), bez sťahovania celého obsahu.

                                                                
OPTIONS — Opýta sa servera, ktoré metódy a možnosti sú pre URL povolené, alebo spustí kontrolu preflight CORS. Hlavičky odpovede, ako Access-Control-Allow-Methods, uvádzajú, čo je povolené. OPTIONS zvyčajne nenesie telo; prehliadače ju často posielajú automaticky pred požiadavkami POST/PUT/PATCH/DELETE medzi pôvodmi.

                                                                
Ľahko sa pomýli: HEAD vs GET — požiadavka je rovnaká, ale HEAD nevráti telo. PUT vs PATCH — PUT nahradí celý zdroj; PATCH použije čiastočnú aktualizáciu len odoslaných polí.