REST del Centro de partners y encabezados de respuesta admitidos por la API REST del Centro de partners

  • Artículo

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

La API rest del Centro de partners admite los siguientes encabezados de solicitud y respuesta HTTP. No todas las llamadas API aceptan todos los encabezados.

Encabezados de solicitud REST

La API rest del Centro de partners admite los siguientes encabezados de solicitud HTTP que admite la API REST del Centro de partners.

Encabezado Descripción Tipo de valor
Authorization: Necesario. Token de autorización en formato de <token> de portador. string
Aceptar: Especifica el tipo de solicitud y respuesta, application/json. string
MS-RequestId: Identificador único de la llamada que se usa para garantizar la eficacia del identificador. Si hay un tiempo de espera, la llamada de reintento debe incluir el mismo valor. Al recibir una respuesta (correcta o con error empresarial), se debe restablecer el valor para la siguiente llamada. GUID
MS-CorrelationId: Identificador único de la llamada. Resulta útil en registros y seguimientos de red para solucionar errores. El valor debe restablecerse para cada llamada. Todas las operaciones deben incluir este encabezado. Para obtener más información, consulte la información del identificador de correlación en Prueba y depuración. GUID
MS-Contract-Version: Necesario. Especifica la versión de la API solicitada; Este valor suele ser api-version: v1 a menos que se especifique lo contrario en la sección Escenarios . string
If-Match: Se usa para el control de simultaneidad. Algunas llamadas API requieren pasar la etiqueta de entidad a través del encabezado If-Match. La etiqueta de entidad normalmente está incluida en el recurso y, por tanto, requiere enviar una solicitud GET a la versión más reciente. Para obtener más información, consulte la información de ETag en Prueba y depuración. string
MS-PartnerCenter-Application Opcional. Especifica el nombre de la aplicación que usa la API REST del Centro de partners. string
X-Configuración regional: Opcional. Especifica el idioma en el que se devuelven las tarifas. El valor predeterminado es en-US. Para obtener una lista de los valores admitidos, consulte Idiomas y configuraciones regionales admitidos en el Centro de partners. string

Encabezados de respuesta REST

La API REST del Centro de partners podría devolver los siguientes encabezados de respuesta HTTP:

Encabezado Descripción Tipo de valor
Aceptar: Especifica el tipo de solicitud y respuesta, application/json. string
MS-RequestId: Identificador único de la llamada que se usa para garantizar la eficacia del identificador. Si hay un tiempo de espera, la llamada de reintento debe incluir el mismo valor. Al recibir una respuesta (correcta o con error empresarial), se debe restablecer el valor para la siguiente llamada. GUID
MS-CorrelationId: Identificador único de la llamada. Este valor es útil para solucionar problemas de registros y seguimientos de red para encontrar el error. El valor debe restablecerse para cada llamada. Todas las operaciones deben incluir este encabezado. GUID