API REST
Une API REST (Representational State Transfer) est une interface HTTP qui organise l'accès aux données et actions sous forme de ressources adressables par URL, manipulées avec les verbes HTTP standards. Les échanges se font souvent en JSON. C'est le style d'API le plus répandu pour connecter frontends, mobiles et services tiers.
Quand on dit « on expose une API » sur un projet web, on parle presque toujours d'une API REST : le frontend Next.js consomme `/users`, `/invoices`, un partenaire s'intègre via des endpoints documentés. Bien conçue (versioning, pagination, codes d'erreur clairs, authentification), elle devient le contrat durable entre équipes et systèmes.
Appeler « REST » une API RPC déguisée (une seule URL POST qui fait tout) crée de la confusion et des clients fragiles. Autre erreur : casser la compatibilité sans versioning, ce qui force tous les consommateurs à se mettre à jour en même temps. Une API REST utile est stable, documentée, et évolue de façon additive autant que possible.
