En-têtes REST et réponse de l’Espace partenaires pris en charge par l’API REST de l’Espace partenaires

  • Article

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

L’API REST de l’Espace partenaires prend en charge les en-têtes de requête et de réponse HTTP suivants. Tous les appels d’API n’acceptent pas tous les en-têtes.

En-têtes de requête REST

L’API REST de l’Espace partenaires prend en charge les en-têtes de requête HTTP suivants sont pris en charge par l’API REST de l’Espace partenaires.

En-tête Description Type de valeur
Authorization : Obligatoire. Jeton d’autorisation au format de <jeton> de porteur. string
Accepter : Spécifie le type de demande et de réponse, application/json. string
MS-RequestId : Identificateur unique de l’appel, utilisé pour garantir la présence d'un ID (id-potency). S’il existe un délai d’expiration, l’appel de nouvelle tentative doit inclure la même valeur. Lors de la réception d’une réponse (réussite ou échec métier), la valeur doit être réinitialisée pour l’appel suivant. GUID
MS-CorrelationId : Identificateur unique de l’appel, utile dans les journaux et les suivis réseau pour la résolution des erreurs. La valeur doit être réinitialisée pour chaque appel. Toutes les opérations doivent inclure cet en-tête. Pour plus d’informations, consultez les informations d’ID de corrélation dans Test et débogage. GUID
MS-Contract-Version : Obligatoire. Spécifie la version de l’API demandée ; Cette valeur est généralement api-version : v1 sauf indication contraire dans la section Scénarios . string
If-Match: Utilisé pour le contrôle d’accès concurrentiel. Certains appels d’API nécessitent la transmission de l’ETag via l’en-tête If-Match. L’ETag étant généralement définie sur la ressource, elle doit obtenir (GET) la plus récente. Pour plus d’informations, consultez les informations ETag dans Test et débogage. string
MS-PartnerCenter-Application facultatif. Spécifie le nom de l’application qui utilise l’API REST de l’Espace partenaires. string
X-Locale : facultatif. Spécifie la langue dans laquelle les taux sont retournés. La valeur par défaut est en-US. Pour obtenir la liste des valeurs prises en charge, consultez les langues et paramètres régionaux pris en charge par l’Espace partenaires. string

En-têtes de réponse REST

L’API REST de l’Espace partenaires peut retourner les en-têtes de réponse HTTP suivants :

En-tête Description Type de valeur
Accepter : Spécifie le type de demande et de réponse, application/json. string
MS-RequestId : Identificateur unique de l’appel, utilisé pour garantir la présence d'un ID (id-potency). S’il existe un délai d’expiration, l’appel de nouvelle tentative doit inclure la même valeur. Lors de la réception d’une réponse (réussite ou échec métier), la valeur doit être réinitialisée pour l’appel suivant. GUID
MS-CorrelationId : Identificateur unique de l’appel. Cette valeur est utile pour résoudre les problèmes liés aux journaux d’activité et aux traces réseau pour trouver l’erreur. La valeur doit être réinitialisée pour chaque appel. Toutes les opérations doivent inclure cet en-tête. GUID