Aller au contenu principal

Request():get()

Exécuter une requête GET et renvoyer un objet Response. Cette méthode est utilisée pour récupérer des données d'une URL spécifiée.

Signature​

get(): Response

Renvoie

Response - L'objet response contenant la réponse du serveur

Description​

La méthode get() envoie une requête HTTP GET à l'URL spécifiée lors de la création de l'objet Request. Les requêtes GET sont généralement utilisées pour récupérer des données d'un serveur sans modifier aucune donnée existante.

Exemples​

Requête GET de base​

-- Créer une requête GET vers un point de terminaison d'API
local response = Request("https://api.example.com/users"):get()

Requête GET avec en-têtes personnalisés​

-- Requête GET avec en-tête d'authentification
local response = Request("https://api.example.com/protected-data")
    :setHeader("Authorization", "Bearer votre-token-ici")
    :setHeader("Accept", "application/json")
    :get()

Traitement de la réponse GET​

-- Effectuer la requête et gérer la réponse
local response = Request("https://jsonplaceholder.typicode.com/posts/1"):get()

-- Obtenir les données de réponse sous forme de chaîne
local data = response:getData()

-- Obtenir le code de statut HTTP
local statusCode = response:getResponseCode()

if statusCode == 200 then
    print("Requête réussie !")
    print("Données de réponse : " .. data)
else
    print("La requête a échoué avec le statut : " .. statusCode)
end

Requête GET avec paramètres de requête​

-- Pour les requêtes GET avec paramètres de requête, incluez-les dans l'URL
local response = Request("https://api.example.com/search?q=lua&limit=10"):get()
local results = response:getData()

Notes​

  • Les requêtes GET ne devraient pas avoir de corps de requête. Si vous devez envoyer des données, utilisez POST() à la place
  • La méthode renvoie un objet Response que vous pouvez utiliser pour accéder aux données de réponse et au code de statut
  • Vérifiez toujours le code de statut de la réponse pour vous assurer que la requête a réussi
  • Les requêtes GET sont idempotentes, ce qui signifie que faire la même requête plusieurs fois devrait avoir le même effet