Les en-têtes HTTP sont les paires clé-valeur jointes à chaque requête et réponse HTTP qui transportent des informations sur la requête elle-même — distinctes du contenu réellement envoyé —, par exemple qui fait la demande, dans quel format les données sont attendues et comment elles doivent être traitées. En gestion de flux, ce sont les en-têtes qui permettent à une plateforme de flux de s'authentifier auprès d'une API, d'indiquer qu'elle envoie ou attend du JSON plutôt que du XML, et de transmettre des instructions de mise en cache ou de compression, sans que ces informations n'encombrent les données produits dans le corps de la requête.
Pourquoi c'est important pour la gestion de flux
Chaque connexion automatisée entre une plateforme de flux et un canal — Google Merchant Center, Meta Catalog, l'ERP propre d'un e-commerçant — dépend du bon fonctionnement des en-têtes. Un en-tête Authorization contenant un jeton invalide ou expiré fera échouer purement et simplement l'envoi d'un flux par ailleurs parfaitement formaté, et un en-tête Content-Type manquant ou incorrect peut amener un canal à interpréter une charge utile JSON comme du texte brut, ou inversement, corrompant silencieusement un import. C'est aussi dans les en-têtes que se trouvent les logiques de limitation de débit et de nouvelle tentative : de nombreuses API renvoient des en-têtes comme Retry-After ou X-RateLimit-Remaining pour indiquer à une plateforme de flux combien de requêtes elle peut encore effectuer avant d'être limitée, ce qui compte lorsqu'il s'agit de synchroniser des dizaines de milliers de SKU avec un canal qui plafonne le nombre de requêtes par minute. Le débogage d'une synchronisation de flux en échec commence souvent par l'inspection des en-têtes, car le corps d'une requête peut sembler parfaitement correct alors qu'un en-tête provoque discrètement le rejet.
Comment cela fonctionne
Les en-têtes sont envoyés sous forme de lignes de texte brut en haut d'une requête ou d'une réponse HTTP, séparément de l'URL et du corps. Une requête type vers une API de flux peut inclure Authorization: Bearer <token> pour prouver l'identité de l'appelant, Content-Type: application/json pour déclarer le format des données envoyées et Accept: application/json pour préciser le format attendu en retour. Contrairement à un paramètre de requête ou aux autres paramètres d'URL qui apparaissent directement dans la barre d'adresse, les en-têtes sont invisibles dans l'URL elle-même, ce qui en fait l'endroit approprié pour des informations sensibles comme les jetons d'authentification, qui ne doivent pas apparaître dans l'historique du navigateur ni dans les logs du serveur. Certains en-têtes sont définis automatiquement par le client ou le serveur (comme Date ou Content-Length), tandis que d'autres — en particulier les en-têtes d'authentification et de suivi personnalisés — sont configurés explicitement par la personne qui construit l'intégration.
Exemple
<!-- Representative HTTP request headers sent when a feed platform
pushes a product update to a channel's API -->
<item>
<g:id>SKU-40217</g:id>
<title>Ceramic Plant Pot - 8 inch, Terracotta</title>
<g:price>18.50 USD</g:price>
<sync_request_headers>
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json
Accept: application/json
</sync_request_headers>
</item>Le bloc sync_request_headers ci-dessus n'est pas un véritable attribut de flux, mais il illustre les métadonnées d'en-tête qui accompagnent les données de cet article chaque fois qu'elles sont transmises à un canal via un appel API plutôt que par l'import d'un fichier en masse.
Concepts associés
Les en-têtes fonctionnent avec — mais séparément des — paramètres de requête et paramètres d'URL qui accompagnent aussi une requête, la différence essentielle étant la visibilité : les en-têtes restent hors de l'URL, c'est pourquoi les jetons d'authentification y sont placés au lieu d'être ajoutés à un lien. Ensemble, ces trois éléments définissent ce que l'API d'un canal reçoit réellement, et une erreur sur l'un d'eux est l'une des causes les plus fréquentes d'échec silencieux d'une synchronisation de flux.
