Backend, données et sécurité Plus de détails A1 · Norme officielle Plateforme: Web

Content Negotiation

Négociation de contenu

La négociation de contenu est la façon dont HTTP choisit une version d'une ressource à partir des préférences du client et des formats disponibles du serveur.

Vous pourriez l'appeler Content Negotiationnégociation de représentationaccepter la négociation

Voir comment cela fonctionne

Exemple travaillé originalNégociation de contenu

Un autre exemple

Une API de rapport envoie `application/json` ou `text/csv` selon `Accept`. Elle retourne 406 si aucune des deux n'est acceptable et ajoute `Vary: Accept`. Cela empêche un cache d'envoyer du CSV à un client JSON. La langue est choisie séparément, et chaque réponse a un `Content-Type` clair.

Parties principales

  1. 01Préférences du client
  2. 02Représentations disponibles
  3. 03Réponse sélectionnée et Vary

Utilisez-le lorsque

Utilisez des en-têtes de requête standard lorsqu'une ressource a réellement des versions différentes de média, de langue, d'encodage ou de préférence.

Ne l'utilisez pas lorsque

Ne créez pas de versions que les caches ne peuvent pas distinguer. Ne ignorez pas silencieusement un type de média requis que le serveur ne prend pas en charge.

Nom utilisé dans le code

Accept / Accept-Language / Accept-Encoding + Content-Type / Content-Language + Vary

Avant d'expédier

Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.

Demande que vous pouvez copier

Outcome: Complete the task with Négociation de contenu (Content Negotiation). User context: Une API de rapport envoie `application/json` ou `text/csv` selon `Accept`. Elle retourne 406 si aucune des deux n'est acceptable et ajoute `Vary: Accept`. Cela empêche un cache d'envoyer du CSV à un client JSON. La langue est choisie séparément, et chaque réponse a un `Content-Type` clair. Technical concept or control: Négociation de contenu (Content Negotiation). Why it fits: Utilisez des en-têtes de requête standard lorsqu'une ressource a réellement des versions différentes de média, de langue, d'encodage ou de préférence. Do not use it when: Ne créez pas de versions que les caches ne peuvent pas distinguer. Ne ignorez pas silencieusement un type de média requis que le serveur ne prend pas en charge. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): La norme couvre uniquement le champ d'application énuméré. Elle ne choisit ni le style visuel, ni la décision de produit, ni l'exemple de Vibulary. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.

Vérifiez cette demande

Review how Négociation de contenu (Content Negotiation) is used now. Definition: La négociation de contenu est la façon dont HTTP choisit une version d'une ressource à partir des préférences du client et des formats disponibles du serveur. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.

A1
Ce terme est-il officiel ?

Norme officielle

Une norme officielle définit les règles décrites sur cette page.

La norme couvre uniquement le champ d'application énuméré. Elle ne choisit ni le style visuel, ni la décision de produit, ni l'exemple de Vibulary.

Portée
Seulement ce que couvre la source:nom canonique、définition、sémantique、mise en œuvre
Statut du document
parcours de normes
Coché activé
2026-07-30

Sources et portée des preuves

Source faisant autorité + Référence de terme · IETF · parcours de normes HTTP Semantics — 12. Content Negotiation 12. Content Negotiation Portée: nom canonique、définition、sémantique、mise en œuvre Rôle ici: Référence directe au terme La source couvre: nom canonique, définition, sémantique, mise en œuvre Source faisant autorité · IETF · parcours de normes HTTP Semantics Portée: nom canonique、définition、sémantique、mise en œuvre Rôle ici: Autorité dans le cadre indiqué La source couvre: nom canonique, définition, sémantique, mise en œuvre

Copiez-le vous-même

Le navigateur n'a pas pu copier ceci. Sélectionnez la requête ci-dessous et copiez-la vous-même.