RFC 9110 - HTTP Semantics

La RFC 9110 est le standard de référence actuel définissant le fonctionnement sémantique du protocole HTTP. Elle remplace et consolide plusieurs RFC précédentes (notamment la 7231).

1. Objectif de la spécification

Elle définit la signification des composants HTTP indépendamment de la version du protocole (HTTP/1.1, HTTP/2 ou HTTP/3) :

• Méthodes de requête : GET, POST, PUT, DELETE, HEAD, OPTIONS.
• Champs d'en-tête (Headers) : Content-Type, Accept, Cache-Control, etc.
• Codes de statut : 200 OK, 404 Not Found, 500 Internal Server Error, etc.

2. Application dans Codexia

Codexia respecte strictement la RFC 9110 dans son architecture API et ses réponses serveur :

• Usage sémantique des méthodes : Utilisation correcte de GET pour la lecture seule et POST/PUT/DELETE pour les mutations d'état.
• Gestion des codes de statut : Utilisation précise des codes (ex: 201 Created après une création d'entité, 403 Forbidden pour les accès refusés via les Voters Symfony).
• Négociation de contenu : Respect de l'en-tête Accept pour servir le format demandé (HTML ou JSON).

3. Points clés pour le développement

• Idempotence : Les méthodes GET, PUT et DELETE doivent être idempotentes (plusieurs appels identiques ne changent pas l'état final au-delà du premier).
• Sécurité : Les méthodes "Safe" (GET, HEAD, OPTIONS) ne doivent jamais modifier l'état du serveur.
• Cache : La gestion sémantique des en-têtes de cache (ETag, Last-Modified) permet d'optimiser les performances de Codexia.

Lien officiel : RFC 9110 (IETF)