Das ist HTTP QUERY
QUERY ist eine sichere, idempotente Methode mit Request-Body — im Grunde ein „GET mit Body“. Komplexe Suchkriterien liegen damit im Body statt in einer aufgeblähten URL, ohne POST zweckzuentfremden, dessen Semantik für Abfragen nicht passt.
HTTP lernen, testen, verifizieren — inklusive der neuen QUERY
QUERY /productsNEWAccept: application/jsonContent-Type: application/json { "category": "boots", "inStock": true}200 OKContent-Location: /products?…Cache-Control: max-age=60 { "results": 42, "cacheable": true}Dieselbe Suche, vier Wege
Dieselbe Produktsuche auf vier Arten:
Horizontal scrollen, um alle Methoden zu vergleichen. QUERY steht zuerst.
| Eigenschaft | QUERY | GET · URL | GET · body | POST |
|---|---|---|---|---|
| Request-Body | JSON | keiner | undefiniert · vermeiden | JSON |
| Sicher (ohne Seiteneffekte) | ✓ | ✓ | ✓ | ✗ |
| Idempotent | ✓ | ✓ | ✓ | ✗ |
| Antwort cachebar | ✓über Content-Location | ✓ | ~unzuverlässig · undefiniert | ~standardmäßig nein · explizit nötig |
| Filter bleiben aus der URL | ✓ | ✗ | ✓ | ✓ |
| Unabhängig von URL-Längenlimits | ✓ | ✗~2 KB Grenze | ✓ | ✓ |
| Standardisiert & unterstützt | ~neues RFC · frühe Verbreitung | ✓ | ✓ | ✓ |
Weiter erkunden
Methoden
Semantik, Sicherheit, Idempotenz und Cachebarkeit von GET / POST / PUT / PATCH / DELETE / HEAD / OPTIONS und der neuen QUERY-Methode.
Playground
Methode wählen, Body ergänzen und eine echte Anfrage an einen Same-Origin-Echo-Endpunkt senden, um zu sehen, wie Methoden wie QUERY tatsächlich ankommen.
Statuscodes
Gängige Statuscodes, gruppiert von 1xx bis 5xx, jeweils mit einer echten HTTP-Nachricht als Beispiel.
Header
Request- und Response-Header nach Funktion gruppiert — Authentifizierung, Caching, Content Negotiation, CORS, Sicherheit — mit Syntax und Beispielen.