Le méthode HTTP QUERY standardisée, combinant les possibilités de GET et POST

Le comité d'ingénierie de l'IETF (Internet Engineering Task Force), chargé du développement des protocoles et de l'architecture du réseau Internet, a attribué au méthode HTTP QUERY le statut de « standard proposé » et a publié la spécification associée RFC 10008. La méthode QUERY envoie des données au serveur de la même manière que la méthode POST, mais se distingue par son orientation, non pas sur l'écriture de données et la modification d'état, mais sur la formulation de requêtes de lecture.

Concernant les tâches résolues, la nouvelle méthode est proche de GET et permet d'envoyer des requêtes qui peuvent être répétées ou redémarrées sans modification de l'état sur le serveur. Comme dans la méthode POST, les paramètres de la requête en QUERY ne sont pas transmis dans l'URI, mais dans le corps de la requête. Cette approche permet de transmettre un grand volume de paramètres dans la requête, dépassant la limite de taille des paramètres dans la méthode GET (8000 octets).

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

Les paramètres envoyés via la méthode QUERY ne sont pas reflétés dans les journaux serveurs, ce qui, d'une part, complique l'analyse des requêtes et le diagnostic des problèmes, mais d'autre part, permet de masquer des données confidentielles dans les journaux des serveurs proxy.

Parmi les domaines d'application de la méthode QUERY, il est mentionné l'envoi de requêtes à des API Web, qui renvoient des résultats au format JSON ou XML, ou à des backends générant du contenu. Pour déterminer la possibilité d'utilisation de la nouvelle méthode lors de l'appel à serveur il est proposé d'utiliser la méthode OPTIONS, et pour déterminer les formats pris en charge, la méthode HEAD :

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

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

La méthode QUERY prévoit la prise en charge de la mise en cache — les serveurs proxy ou les gestionnaires peuvent conserver le résultat de l'exécution de la requête, lui attribuer un URI pour un appel ultérieur via la méthode GET et renvoyer des informations sur la fourniture de la version mise en cache par l'en-tête « Last-Modified ». Pour vérifier l'existence de changements depuis la dernière requête, l'en-tête « If-Modified-Since » peut être utilisé. Pour indiquer des alternatives pour l'exécution de la requête, des en-têtes « Content-Location » et « Location » peuvent être spécifiés dans la réponse, la différence étant que le premier transmet un lien pour obtenir le résultat de la requête précédemment effectuée, tandis que le second est destiné à répéter la requête avec les mêmes paramètres.

> QUERY /contacts HTTP/1.1
> Host: example.org
> Content-Type: application/x-www-form-urlencoded
> Accepter: 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
Dernière modification: sam., 25 août 2012 23:34:45 GMT
Date: dim., 17 nov. 2024, 16:10:24 GMT

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

En plus du type « application/x-www-form-urlencoded », des formats avancés comme JSONPath (application/jsonpath), XSLT (application/xslt+xml) et SQL (application/sql) peuvent être utilisés directement pour transmettre des paramètres dans les requêtes QUERY. Les formats pris en charge sont retournés serveur dans l'en-tête 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
> Accepter: application/json
>
> $..[
> ?@.errata_status_code=="Rejected"
> && @.submit_date>"2024"
> ]
> ["doc-id"]

Source : opennet.ru