Cabeceras de REST del Centro de partnersPartner Center REST headers

Se aplica aApplies To

  • Centro de partnersPartner Center
  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

La API de REST del centro de Partners admite los siguientes encabezados de solicitud y respuesta HTTP.The following HTTP request and response headers are supported by the Partner Center REST API. No todas las llamadas API aceptan todos los encabezados.Not all API calls accept all headers.

Encabezados de solicitud RESTREST request headers

La API de REST del centro de Partners admite los siguientes encabezados de solicitud HTTP.The following HTTP request headers are supported by the Partner Center REST API.

EncabezadoHeader DescripciónDescription Tipo de valorValue Type
Autorización:Authorization: Obligatorio.Required. El token de autorización en la forma de <token> de portador.The authorization token in the form Bearer <token>. stringstring
AceptAccept: Especifica los tipos de solicitud y respuesta, "application/json".Specifies the request and response type, "application/json". stringstring
MS-RequestId:MS-RequestId: Id. único de la llamada, se usa para garantizar la eficacia del Id.A unique identifier for the call, used to ensure id-potency. Si se agota el tiempo de espera, la llamada de reintento debe incluir el mismo valor.If there's a timeout, the retry call should include the same value. Al recibir una respuesta (realización correcta o con error empresarial), se debe restablecer el valor para la siguiente llamada.Upon receiving a response (success or business failure), the value should be reset for the next call. GUIDGUID
MS-CorrelationId:MS-CorrelationId: Id. único para la llamada, útil en registros y seguimientos de red para solucionar errores.A unique identifier for the call, useful in logs and network traces for troubleshooting errors. El valor debe restablecerse para cada llamada.The value should be reset for every call. Todas las operaciones deben incluir este encabezado.All operations should include this header. Para obtener más información, vea la información sobre el identificador de correlación en Test and Debug.For more information, see the Correlation ID information in Test and debug. GUIDGUID
Versión de contrato MS:MS-Contract-Version: Obligatorio.Required. Especifica la versión de la API solicitada. Normalmente, versión de API: v1, a menos que se especifique lo contrario en la sección de escenarios .Specifies the version of the API requested; generally api-version: v1 unless otherwise specified in the Scenarios section. stringstring
If-Match:If-Match: Se usa para el control de simultaneidad.Used for concurrency control. Algunas llamadas API requieren pasar la ETag a través del encabezado If-Match.Some API calls require passing the ETag via the If-Match header. La ETag normalmente está incluida en el recurso y, por tanto, requiere enviar una solicitud GET a la versión más reciente.The ETag is usually on the resource and therefore, requires GET-ting the latest. Para obtener más información, vea la información de ETag en Test and Debug.For more information, see the ETag information in Test and debug. stringstring
MS-PartnerCenter: aplicaciónMS-PartnerCenter-Application Opcional.Optional. Especifica el nombre de la aplicación que usa la API de REST del centro de Partners.Specifies the name of the application that is using the Partner Center REST API. stringstring
Configuración regional X:X-Locale: Opcional.Optional. Especifica el idioma en el que se devuelven las tarifas.Specifies the language in which the rates are returned. El valor predeterminado es "en-US".Default is "en-US". Para obtener una lista de valores admitidos, consulte idiomas y configuraciones regionales admitidosen el centro de Partners.For a list of supported values, see Partner Center supported languages and locales. stringstring

Encabezados de respuesta de RESTREST response headers

La API de REST del centro de Partners puede devolver los siguientes encabezados de respuesta HTTP.The following HTTP response headers may be returned by the Partner Center REST API.

EncabezadoHeader DescripciónDescription Tipo de valorValue Type
AceptAccept: Especifica los tipos de solicitud y respuesta, "application/json".Specifies the request and response type, "application/json". stringstring
MS-RequestId:MS-RequestId: Id. único de la llamada, se usa para garantizar la eficacia del Id.A unique identifier for the call, used to ensure id-potency. Si se agota el tiempo de espera, la llamada de reintento debe incluir el mismo valor.If there's a timeout, the retry call should include the same value. Al recibir una respuesta (realización correcta o con error empresarial), se debe restablecer el valor para la siguiente llamada.Upon receiving a response (success or business failure), the value should be reset for the next call. GUIDGUID
MS-CorrelationId:MS-CorrelationId: Identificador único de la llamada.A unique identifier for the call. Este valor es útil para la solución de problemas de registros y seguimientos de red para encontrar el error.This value is useful for troubleshooting logs and network traces to find the error. El valor debe restablecerse para cada llamada.The value should be reset for every call. Todas las operaciones deben incluir este encabezado.All operations should include this header. GUIDGUID