Partage via

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 pour Microsoft Cloud pour le gouvernement des États-Unis

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.

En-tête Description Type de valeur
Authorization: Obligatoire. Jeton d’autorisation sous la forme <jeton> de porteur. chaîne
Accept: Spécifie le type de requête et de réponse, application/json. chaîne
MS-RequestId: Identificateur unique pour l’appel, utilisé pour garantir la puissance de l’ID. 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 commercial), la valeur doit être réinitialisée pour l’appel suivant. GUID
MS-CorrelationId: Identificateur unique pour l’appel, utilisé dans les journaux et les traces de 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 sur l’ID de corrélation dans Tester et déboguer. 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. chaîne
If-Match: Utilisé pour le contrôle de la concurrence. Certains appels d’API nécessitent le passage de l’ETag via l’en-tête If-Match. L’étiquette d’entité (ETag) se trouve généralement sur la ressource et nécessite donc de l’obtenir le plus récent par une requête GET. Pour plus d’informations, consultez les informations sur l’ETag dans Tester et déboguer. chaîne
MS-PartnerCenter-Application Optionnel. Spécifie le nom de l’application qui utilise l’API REST de l’Espace partenaires. chaîne
X-Locale: Optionnel. 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 Langues et paramètres régionaux pris en charge par l’Espace partenaires. chaîne

En-têtes de réponse REST

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

En-tête Description Type de valeur
Accept: Spécifie le type de requête et de réponse, application/json. chaîne
MS-RequestId: Identificateur unique pour l’appel, utilisé pour garantir la puissance de l’ID. 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 commercial), 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