💻 Programmation🟡 Intermédiaire⏱ 1 min de lecture📂 🌍 Outils et web

💻 Programmation · Outils et web

API REST

Une API REST expose des ressources (utilisateurs, messages…) via des URL, manipulées avec les méthodes HTTP. Les données circulent en général en JSON.

Schéma
GET    /api/users       liste les utilisateurs
GET    /api/users/42    lit l'utilisateur 42
POST   /api/users       crée un utilisateur
PATCH  /api/users/42    modifie l'utilisateur 42
DELETE /api/users/42    supprime l'utilisateur 42

Les principes

  • Les ressources ont des URL (des noms au pluriel, pas de verbes)
  • Les méthodes HTTP sont les actions
  • Sans état : chaque requête contient tout ce qu'il faut
  • Des codes de statut parlants (200, 201, 404…)

Authentification

Clé d'API ou jeton dans l'en-tête Authorization: Bearer <jeton>. HTTPS obligatoire, et jamais de secret dans l'URL.

Limites de débit

Les API limitent le nombre de requêtes (429 Too Many Requests, en-tête Retry-After). L'API de Discord le fait : discord.js gère ces limites à ta place.

Tester

  • curl -X POST https://api.exemple.fr/users -H "Content-Type: application/json" -d '{"nom":"Alex"}'
  • Sous PowerShell, curl est un alias : utilise curl.exe ou Invoke-RestMethod
  • Ou Postman, Insomnia, Bruno

Versionner

Préfixe l'API (/v1/…) pour pouvoir la faire évoluer sans casser les clients existants.

📌 À retenir

URL de ressources + méthodes HTTP + JSON + bons codes de statut.

Teste-toi

Quelle méthode HTTP sert à lire une ressource sans la modifier ?
  1. POST
  2. GET
  3. PUT
  4. DELETE

Réponse : B. GET

GET lit, POST crée, PUT/PATCH modifient, DELETE supprime.

Plus de questions dans Discord avec /qcm matiere:dev.

Pour aller plus loin

HTTP et HTTPSHTTP est le protocole du web : un client envoie une requête, le serveur renvoie une réponse. HTTPS = HTTP dans un…Les codes de statut HTTPChaque réponse HTTP commence par un code à 3 chiffres : le premier chiffre donne la famille.JSONJSON est un format texte léger pour échanger des données structurées. Lisible par les humains, compris par presque…Asynchrone : promesses et async/awaitCertaines opérations (réseau, disque, base de données) prennent du temps. Plutôt que de bloquer le programme, on les…

Fiche mise à jour le 6 novembre 2026. Une erreur, une précision à proposer ? Écris-nous.