Une REST API (Representational State Transfer Application Programming Interface) est une interface qui permet à deux systèmes de communiquer via le protocole HTTP. Elle définit un ensemble d'endpoints (URLs) sur lesquels on peut effectuer des opérations CRUD (GET, POST, PUT, DELETE) pour manipuler des ressources.
Les principes fondamentaux de REST sont : l'identification des ressources par des URLs (/users, /orders/123), l'utilisation des méthodes HTTP standard, les réponses stateless (chaque requête contient toute l'information nécessaire), et un format d'échange standardisé (généralement JSON). Ces principes garantissent une API prévisible, documentable et interopérable.
Dans l'écosystème PHP/Symfony, API Platform est la solution de référence pour construire des REST API conformes aux standards (JSON-LD, OpenAPI). Une API bien conçue permet de découpler le front-end du back-end, de servir plusieurs clients (web, mobile, partenaires) avec le même back-end et de faciliter les intégrations avec des systèmes tiers.
