Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Méthode de requête GET

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨juillet 2015⁩.

La méthode HTTP GET demande une représentation de la ressource spécifiée. Les requêtes utilisant GET doivent uniquement servir à demander des données et ne doivent pas contenir de corps.

Note : La sémantique de l'envoi d'un corps de message dans une requête GET n'est pas définie. Certains serveurs peuvent refuser la requête avec une erreur client 4XX.

La requête a un corps Non
La réponse de succès a un corps Oui
Sûre Oui
Idempotente Oui
Mis en cache Oui
Autorisée dans les formulaires HTML Oui

Syntaxe

http
GET <request-target>["?"<query>] HTTP/1.1
<request-target>

Identifie la ressource cible de la requête lorsqu'elle est combinée avec l'information fournie par l'en-tête Host. Il s'agit d'un chemin absolu (par exemple /chemin/vers/fichier.html) pour les requêtes vers un serveur d'origine et d'une URL absolue pour les requêtes vers les serveurs mandataires (proxies) (par exemple http://www.exemple.fr/chemin/vers/fichier.html).

<query> Facultatif

Un fragment de requête optionnel précédé d'un point d'interrogation ?. Utilisé généralement pour fournir de l'information sous la forme de paires clé=valeur.

Exemples

Récupération réussie d'une ressource

La requête GET suivante demande la ressource située à exemple.fr/contact :

http
GET /contact HTTP/1.1
Host: exemple.fr
User-Agent: curl/8.6.0
Accept: */*

Le serveur renvoie la ressource avec le code de statut 200 OK, indiquant le succès :

http
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Fri, 21 Jun 2024 14:18:33 GMT
Last-Modified: Thu, 17 Oct 2019 07:18:26 GMT
Content-Length: 1234

<!doctype html>
<!-- Contenu HTML -->

Spécifications

Specification
HTTP Semantics
# GET

Compatibilité des navigateurs

Voir aussi