Compartir a través de

Encabezados REST y de respuesta del Centro de partners compatibles con la API de REST del Centro de partners

  • Artículo

se aplica a: Centro de socios | Centro de socios operado por 21Vianet | Centro de socios para Microsoft Cloud para el Gobierno de EE.UU.

La API REST del Centro de socios 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 asociados admite los siguientes encabezados de solicitud HTTP.

Encabezado Descripción Tipo de valor
Authorization: Obligatorio. El token de autorización en el formato portador de <token>. cadena
Accept: Especifica el tipo de solicitud y respuesta, application/json. cadena
MS-RequestId: Identificador único de la llamada, que se usa para garantizar la potencia del identificador. Si hay un tiempo de espera, la llamada de reintento debe incluir el mismo valor. Al recibir una respuesta (éxito o error empresarial), el valor debe restablecerse para la siguiente llamada. GUID
MS-CorrelationId: Identificador único de la llamada, ú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: Obligatorio. 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 de . cadena
If-Match: Se usa para el control de simultaneidad. Algunas llamadas API requieren pasar el ETag a través del encabezado If-Match. La ETag suele estar en el recurso y, por lo tanto, requiere realizar un GET para obtener la última versión. Para obtener más información, consulte la información de ETag en Prueba y depuración. cadena
MS-PartnerCenter-Application Opcional. Especifica el nombre de la aplicación que usa la API REST del Centro de socios. cadena
X-Locale: 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 del Centro de partners. cadena

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
Accept: Especifica el tipo de solicitud y respuesta, application/json. cadena
MS-RequestId: Identificador único de la llamada, que se usa para garantizar la potencia del identificador. Si hay un tiempo de espera, la llamada de reintento debe incluir el mismo valor. Al recibir una respuesta (éxito o error empresarial), el valor debe restablecerse 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