Symfony – Consommer une API

Cours 37 — Consommer une API

Introduction

Consommer une API consiste à interroger un service externe afin de récupérer des données.

Symfony fournit un composant HTTP Client pour effectuer ces requêtes.

---

Installer le composant

composer require symfony/http-client

---

Injection du client HTTP

use Symfony\Contracts\HttpClient\HttpClientInterface;

---

Exemple simple

public function index(
    HttpClientInterface $httpClient
): Response
{
}

Symfony fournit automatiquement le client HTTP.

---

Envoyer une requête GET

$response = $httpClient->request(
    'GET',
    'https://api.exemple.com/patients'
);

---

Lire la réponse

$donnees = $response->toArray();

---

Exemple complet

$response = $httpClient->request(
    'GET',
    'https://api.exemple.com/patients'
);

$donnees = $response->toArray();

---

Accéder aux données

$nom = $donnees['nom'];

---

Envoyer des données

$response = $httpClient->request(
    'POST',
    'https://api.exemple.com/patients',
    [
        'json' => [
            'nom' => 'Durand'
        ]
    ]
);

---

Comprendre le processus

Symfony
↓
Requête HTTP
↓
API distante
↓
Réponse JSON
↓
Traitement

---

Utilisation fréquente

Météo
Paiement
Cartographie
Services externes

---

Conclusion

Consommer une API permet d’utiliser des services externes.

Éléments à retenir :

HttpClientInterface

request()

toArray()