Standardiserad HTTP-metod QUERY, som kombinerar funktionerna hos GET och POST

Ingenjörskommittén IETF (Internet Engineering Task Force), som arbetar med utvecklingen av protokoll och arkitekturen för internet, gav HTTP-metoden QUERY status som "Föreslagen standard" och publicerade relaterad specifikation RFC 10008. Metod QUERY efterliknar POST när det gäller dataskickande till servern, men skiljer sig från den i och med att den inte är inriktad på att skriva data och ändra tillstånd, utan att skapa förfrågningar för läsning.

När det gäller problemen som löses är den nya metoden nära relaterad till GET och tillåter att skicka förfrågningar som kan upprepas eller startas om utan att ändra tillståndet på servern. Precis som i metoden POST överförs parametrarna i QUERY inte i URI, utan i förfrågningskroppen. Denna metod möjliggör överföring av en stor mängd parametrar i förfrågan som överskrider gränsen för parameterns storlek i GET-metoden (8000 byte).

GET /feed?q=foo&limit=10&sort=-published HTTP/1.1
Host: example.org

QUERY /feed HTTP/1.1
Host: example.org
Content-Type: application/x-www-form-urlencoded

q=foo&limit=10&sort=-published

Parametrar skickade via QUERY-metoden syns inte i loggarna servrar, vilket å ena sidan komplicerar analysen av förfrågningar och diagnostik av problem, men å andra sidan möjliggör att dölja konfidentiella uppgifter från loggar på proxyservrar.

Inom tillämpningsområdena för QUERY-metoden nämns att skicka förfrågningar till Web API:er, som ger resultat i JSON- eller XML-format, eller backend-system som genererar innehåll. För att bestämma möjligheten att använda den nya metoden vid anrop till servern föreslås att använda metoden OPTIONS, och för att fastställa stödja format, metoden HEAD:

> OPTIONS /contacts HTTP/1.1
> Host: example.org

HTTP/1.1 200 OK
Allow: GET, QUERY, OPTIONS, HEAD

Metoden QUERY stöder caching — proxyservrar eller handlare kan spara resultatet av en förfrågan, tilldela det en URI för framtida åtkomst via metoden GET och returnera information om utslaget av den cachade versionen genom rubriken "Last-Modified". För att kontrollera om det har skett förändringar sedan den senaste förfrågan kan rubriken "If-Modified-Since" användas. Alternativa sätt att genomföra förfrågan kan anges i svaret med hjälp av rubrikerna "Content-Location" och "Location", där skillnaden är att den första överför en länk för att hämta resultatet av en tidigare genomförd förfrågan, medan den andra är avsedd för att upprepa förfrågan med samma parametrar.

> QUERY /contacts HTTP/1.1
> Host: example.org
> Content-Type: application/x-www-form-urlencoded
> Accept: application/json
> select=surname,givenname,email&limit=10&match="email=*@example.*"

HTTP/1.1 200 OK
Content-Type: application/json
Content-Location: /contacts/stored-results/17
Location: /contacts/stored-queries/42
Last-Modified: Sat, 25 Aug 2012 23:34:45 GMT
Date: Sun, 17 Nov 2024, 16:10:24 GMT

> GET /contacts/stored-results/17 HTTP/1.1
> Host: example.org
> Accept: application/json

Förutom typen "application/x-www-form-urlencoded" kan även avancerade format, såsom JSONPath (application/jsonpath), XSLT (application/xslt+xml) och SQL (application/sql), användas direkt för att överföra parametrar i QUERY-förfrågningar. De stödda formaten returneras servern i rubriken Accept-Query.

> HEAD /contacts HTTP/1.1
> Host: example.org

HTTP/1.1 200 OK
Content-Type: application/xhtml
Accept-Query: application/x-www-form-urlencoded, application/jsonpath, application/sql

> QUERY /errata.json HTTP/1.1
> Host: example.org
> Content-Type: application/jsonpath
> Accept: application/json
>
> $..[
> ?@.errata_status_code=="Rejected"
> && @.submit_date>"2024"
> ]
> ["doc-id"]

Källa: opennet.ru