Files
wiki/concepts/api-rest.md
T
2026-06-09 18:40:21 +02:00

1.3 KiB

title, created, updated, type, tags, confidence, contested, sources
title created updated type tags confidence contested sources
API REST 2026-06-06 2026-06-06 concept
tech
protocol
web
high false
synthesized

📡 API REST

Définition Courte

REpresentational State Transfer : style d'architecture pour les APIs web basé sur le protocole HTTP, les méthodes standard (GET, POST, PUT, DELETE) et des ressources identifiées par URL.

Explication Détaillée

REST a été défini par Roy Fielding en 2000. Les principes clés :

  • Stateless : chaque requête contient toute l'info nécessaire (pas de session serveur).
  • Ressources identifiées par URI (/users/42).
  • Représentations : JSON, XML, etc. (le plus souvent JSON aujourd'hui).
  • Méthodes HTTP sémantiques : GET (lecture), POST (création), PUT/PATCH (modif), DELETE (suppression).
  • HATEOAS (optionnel) : liens hypermédia dans les réponses.

Cas d'Usage

  • APIs publiques (GitHub, Stripe, Twilio).
  • Communication frontend ↔ backend.
  • Microservices.

Outils Liés

  • Frameworks : Express, FastAPI, Gin, Spring.
  • Documentation : OpenAPI / Swagger.
  • Tests : Postman, Insomnia, HTTPie.

Pages Liées

Questions Ouvertes

  • REST vs GraphQL : quel trade-off pour quel projet ?
  • Comment versionner une API REST proprement ?