En-têtes HTTP

Cette section décrit les en-têtes HTTP que l’API acceptera pour toute requête.

Content-Type

Toutes les requêtes doivent contenir un en-tête HTTP Content-Type.

Types de contenu acceptés

Format de base	Types de contenu	Types de contenu
JSON	application/json	text/json n’est actuellement pas un type de contenu accepté
Données de formulaire	multipart/form-data	Utilisé uniquement lors du téléversement de variations

Erreurs de Content-Type

Code de réponse	Remarques
400	Le type de contenu a été compris mais n’a pas pu être décodé. Davantage d’informations apparaîtront dans le corps de la réponse
415	Le type de contenu est manquant ou n’est pas pris en charge

Remarque: Dans les cas où l’en-tête content-type présente un problème, le type de contenu de la réponse sera le format par défaut de l’API, actuellement application/json

Remarque: L’API ne respecte actuellement pas l’en-tête HTTP Accept-type, toutes les réponses sont envoyées dans le même type de contenu que la requête reçue, à condition que le type de contenu de la requête soit valide

Autorisation

Cet en-tête est facultatif et sert à fournir à l’API les détails d’authentification du utilisateur actuel, ce qui lui permettra d’accéder aux ressources API restreintes. Les jetons peuvent être obtenus via l’API de connexion. Voici un exemple d’en-tête :

Authorization: Bearer 45267dbe480c8c7d799c62ccad92cb44f67ab086

L’en-tête Authorization accepte une chaîne composée de deux parties, séparées par un seul espace. La première partie est le type de jeton, la seconde est le jeton d’accès lui-même.

Erreurs d’autorisation

Code de réponse	Remarques
400	Un en-tête d’autorisation mal formé a été fourni
401	L’en-tête d’autorisation est manquant ou le jeton était invalide ou expiré

Choisir un type de jeton d’autorisation

En cas d’échec, les en-têtes de réponse contiendront un en-tête WWW-Authenticate qui indiquera le type de jeton requis pour l’accès.