En-têtes REST et réponse de l’Espace partenaires pris en charge par l’API REST de l’Espace partenaires
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 |