REST del Centro de partners y encabezados de respuesta admitidos por la API REST del Centro de partners
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 |