REST API-kliens / -tesztelő

HTTP-kérések összeállítása és küldése lekérdezési paraméterekkel, fejlécekkel, JSON-/űrlaptörzsekkel és Basic vagy Bearer hitelesítéssel, majd az állapot, az időzítés és a szépen formázott JSON-válaszok megvizsgálása. Egy meglévő cURL-parancs importálható, vagy az aktuális kérés cURL-ként visszamásolható. Lépésenként összeállított, újrahasználható kérésekhez a HTTP-kéréskészítő szolgál. Az API-eszközök család is kapcsolódik.
Minden helyben fut a böngészőben. A származáson kívüli kéréseket a célkiszolgáló CORS-szabályzata korlátozza — ha egy kérés meghiúsul, az alábbi megjegyzés magyarázza.
CURL-parancs beillesztése
Lekérdezési paraméterek
Fejlécek
Törzs
Authorization
Beállítások
Kitöltés esetén a kérés URL-je ehhez az előtaghoz fűződik. CORS-tiltott kiszolgálóknál hasznos.
200
Törzs Fejlécek

                                                                

                                                                

                                                                    

                                                                

                                                            


                                                            

                                                            
Miért bukhat meg egy kérés: a böngészők blokkolják a származáson kívüli olvasást, hacsak az API nem adja vissza a Access-Control-Allow-Origin fejlécet. Ha a cél nem engedélyezi a CORS-t, egy CORS-proxy futtatható, és annak URL-je
                                                                beilleszthető a fenti proxy-előtagba, vagy a cURL-átalakítóval a kérés terminálból futtatható. A GET/HEAD kérések törzse figyelmen kívül marad, a WebSocket-eszköz pedig külön található itt:
                                                                WebSocket-tesztelő.


                                                            

                                                                A HTTP-metódusok magyarázata
                                                                
A kiválasztott metódus megmondja a kiszolgálónak, mit kell tenni az URL-lel. Íme, mit jelent az eszköz által küldhető hét ige mindegyike:

                                                                
GET — Erőforrás lekérése: weboldal, kép, rekordlista. “Ami ezen az URL-en található.” Csak olvas, ismételhető biztonsággal, és általában nincs kérés-törzse (a GET-kérés esetleges törzsét a rendszer figyelmen kívül hagyja).

                                                                
POST — Új adatok küldése a kiszolgálónak, általában erőforrás létrehozásához vagy művelet elindításához — űrlap beküldése, fájl feltöltése, feladat indítása. A tartalom a kérés törzsében utazik. A POST nem idempotens: ugyanazon POST kétszeri elküldése két rekordot is létrehozhat.

                                                                
PUT — Az URL-en lévő teljes erőforrást lecseréli az elküldött tartalommal. A törzsnek az erőforrás teljes új változatát kell tartalmaznia. A PUT idempotens: ugyanazon kérés megismétlése ugyanazt a hatást éri el, mint az egyszeri elküldése.

                                                                
PATCH — Az erőforrásnak csak egy részét módosítja. Csak a frissíteni kívánt mezők küldhetők el, pl. {"email": "new@example.com"}, az egész rekord helyett. A PATCH akkor javasolt, ha egy teljes PUT miatt olyan mezőket is újra kellene küldeni, amelyek nem változnak.

                                                                
DELETE — Eltávolítja az erőforrást az URL-en. A DELETE idempotens: már nem létező dolog törlése ugyanazt az eredményt adja (általában 404), és kétszer nem tesz semmit.

                                                                
HEAD — Pontosan mint a GET, de a válasz csak fejléceket tartalmaz — törzset egyáltalán nem küld vissza. A HEAD használható annak ellenőrzésére, hogy létezik-e az URL, mekkora a fájl (Content-Length), mikor módosították utoljára (Last-Modified), vagy milyen típusú (Content-Type), anélkül, hogy a teljes adatcsomag letöltődne.

                                                                
OPTIONS — Megkérdezi a kiszolgálótól, mely metódusok és beállítások engedélyezettek egy URL-hez, vagy CORS-előellenőrzést indít. A válaszfejlécek, például az Access-Control-Allow-Methods, felsorolják, mi engedélyezett. Az OPTIONS általában nem tartalmaz törzset; a böngészők gyakran automatikusan küldik a származáson kívüli POST/PUT/PATCH/DELETE kérések előtt.

                                                                
Könnyen összekeverhető: HEAD vs GET — a kérés azonos, de a HEAD nem ad vissza törzset. PUT vs PATCH — a PUT az egész erőforrást lecseréli; a PATCH csak az elküldött mezők részleges frissítését alkalmazza.