Voici HTTP QUERY
QUERY est une méthode sûre et idempotente qui transporte un corps de requête — en somme un « GET avec corps ». Les critères de recherche complexes vivent dans le corps plutôt que dans une URL boursouflée, sans détourner POST, dont la sémantique ne convient pas à une interrogation.
Apprendre, tester et vérifier HTTP — y compris le nouveau 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}La même recherche, quatre façons
La même recherche de produits de quatre façons :
Faites défiler horizontalement pour comparer les méthodes. QUERY apparaît en premier.
| Capacité | QUERY | GET · URL | GET · body | POST |
|---|---|---|---|---|
| Corps de la requête | JSON | aucun | indéfini · à éviter | JSON |
| Sûr (sans effet de bord) | ✓ | ✓ | ✓ | ✗ |
| Idempotent | ✓ | ✓ | ✓ | ✗ |
| Réponse cacheable | ✓via Content-Location | ✓ | ~peu fiable · indéfini | ~non par défaut · explicite requis |
| Filtres hors de l’URL | ✓ | ✗ | ✓ | ✓ |
| Insensible aux limites d’URL | ✓ | ✗plafond ~2 Ko | ✓ | ✓ |
| Normalisé et pris en charge | ~nouveau RFC · adoption précoce | ✓ | ✓ | ✓ |
Poursuivre l’exploration
Méthodes
Sémantique, sûreté, idempotence et mise en cache de GET / POST / PUT / PATCH / DELETE / HEAD / OPTIONS et de la nouvelle méthode QUERY.
Playground
Choisissez une méthode, ajoutez un corps et envoyez une vraie requête vers un point d’accès echo de même origine pour voir précisément comment des méthodes comme QUERY sont reçues.
Codes de statut
Parcourez les codes de statut courants regroupés de 1xx à 5xx, chacun avec un exemple de message HTTP réel.
En-têtes
En-têtes de requête et de réponse regroupés par fonction — authentification, cache, négociation de contenu, CORS, sécurité — avec syntaxe et exemples.