Effectuer des requêtes HTTP en Ruby

Ruby est un langage de programmation polyvalent et puissant, souvent utilisé pour le développement web. L'une des tâches courantes dans le développement d'applications web est d'effectuer des requêtes HTTP pour interagir avec des API ou récupérer des données à partir d'autres services. Dans cet article, nous allons explorer comment effectuer des requêtes HTTP en Ruby de manière simple et efficace.

Introduction aux requêtes HTTP

HTTP (HyperText Transfer Protocol) est le protocole de communication utilisé sur le web. Il permet aux clients (comme les navigateurs web) de demander des ressources à des serveurs. Les requêtes HTTP peuvent être de différents types, notamment :

GET : pour récupérer des données.
POST : pour envoyer des données au serveur.
PUT : pour mettre à jour des données existantes.
DELETE : pour supprimer des données.

Dans cet article, nous allons nous concentrer principalement sur les requêtes GET et POST, qui sont les plus couramment utilisées.

Bibliothèques Ruby pour les requêtes HTTP

Ruby dispose de plusieurs bibliothèques pour effectuer des requêtes HTTP. Les plus populaires sont :

Net::HTTP : une bibliothèque standard incluse avec Ruby.
HTTParty : une bibliothèque tierce qui simplifie les requêtes HTTP.
RestClient : une autre bibliothèque tierce qui offre une interface simple pour les requêtes HTTP.

Nous allons examiner chacune de ces bibliothèques et voir comment les utiliser pour effectuer des requêtes HTTP.

Utilisation de Net::HTTP

La bibliothèque Net::HTTP est incluse par défaut dans Ruby, ce qui signifie que vous n'avez pas besoin d'installer de gemmes supplémentaires. Voici comment l'utiliser pour effectuer des requêtes GET et POST.

Effectuer une requête GET

Pour effectuer une requête GET avec Net::HTTP, vous pouvez utiliser le code suivant :

require 'net/http'
require 'uri'

url = URI.parse('http://example.com')
response = Net::HTTP.get_response(url)

puts response.body

Dans cet exemple, nous avons :

Importé les bibliothèques nécessaires.
Défini l'URL à laquelle nous voulons faire la requête.
Utilisé Net::HTTP.get_response pour obtenir la réponse du serveur.
Affiché le corps de la réponse.

Effectuer une requête POST

Pour effectuer une requête POST, vous pouvez utiliser le code suivant :

require 'net/http'
require 'uri'

url = URI.parse('http://example.com/api')
http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url.path)
request['Content-Type'] = 'application/json'
request.body = '{"key": "value"}'

response = http.request(request)

puts response.body

Dans cet exemple, nous avons :

Créé une nouvelle instance de Net::HTTP pour gérer la connexion.
Créé une nouvelle requête POST avec Net::HTTP::Post.
Défini l'en-tête Content-Type pour indiquer que nous envoyons des données JSON.
Ajouté le corps de la requête avec des données JSON.
Effectué la requête et affiché la réponse.

Utilisation de HTTParty

HTTParty est une bibliothèque populaire qui simplifie le processus d'envoi de requêtes HTTP. Pour l'utiliser, vous devez d'abord l'installer. Vous pouvez le faire en ajoutant la ligne suivante à votre fichier Gemfile :

gem 'httparty'

Ensuite, exécutez bundle install pour installer la gemme.

Effectuer une requête GET avec HTTParty

Voici comment effectuer une requête GET avec HTTParty :

require 'httparty'

response = HTTParty.get('http://example.com')

puts response.body

HTTParty rend les requêtes très simples. Vous pouvez également accéder à d'autres informations sur la réponse, comme le code d'état :

puts response.code

Effectuer une requête POST avec HTTParty

Pour effectuer une requête POST, vous pouvez utiliser le code suivant :

require 'httparty'

response = HTTParty.post('http://example.com/api', 
                          body: { key: 'value' }.to_json,
                          headers: { 'Content-Type' => 'application/json' })

puts response.body

Dans cet exemple, nous avons :

Utilisé HTTParty.post pour envoyer une requête POST.
Passé le corps de la requête sous forme de JSON.
Défini l'en-tête Content-Type pour indiquer que nous envoyons des données JSON.

Utilisation de RestClient

RestClient est une autre bibliothèque qui facilite l'envoi de requêtes HTTP. Pour l'utiliser, vous devez également l'installer via votre Gemfile :

gem 'rest-client'

Après l'installation, vous pouvez l'utiliser comme suit :

Effectuer une requête GET avec RestClient

require 'rest-client'

response = RestClient.get('http://example.com')

puts response.body

Effectuer une requête POST avec RestClient

require 'rest-client'
require 'json'

response = RestClient.post('http://example.com/api', 
                            { key: 'value' }.to_json, 
                            { content_type: :json, accept: :json })

puts response.body

RestClient est très intuitif et vous permet d'envoyer des requêtes avec moins de code.

Gestion des erreurs

Lorsque vous effectuez des requêtes HTTP, il est important de gérer les erreurs potentielles. Voici quelques conseils pour gérer les erreurs avec les bibliothèques que nous avons examinées :

Utilisez des blocs begin-rescue pour capturer les exceptions.
Vérifiez le code d'état de la réponse pour déterminer si la requête a réussi.
Affichez des messages d'erreur clairs pour aider au débogage.

Exemple de gestion des erreurs avec Net::HTTP

begin
  response = Net::HTTP.get_response(url)
  if response.is_a?(Net::HTTPSuccess)
    puts response.body
  else
    puts "Erreur : #{response.code} - #{response.message}"
  end
rescue StandardError => e
  puts "Une erreur s'est produite : #{e.message}"
end

Conclusion

Effectuer des requêtes HTTP en Ruby est une tâche essentielle pour interagir avec des API et récupérer des données. Que vous choisissiez d'utiliser Net::HTTP, HTTParty ou RestClient, chaque bibliothèque a ses propres avantages et inconvénients. En fonction de vos besoins, vous pouvez choisir celle qui vous convient le mieux.

Nous espérons que cet article vous a aidé à comprendre comment effectuer des requêtes HTTP en Ruby. N'hésitez pas à explorer davantage ces bibliothèques et à les utiliser dans vos projets !