API de envío del Centro de partners para incorporar aplicaciones de Azure en el centro de Partners

  • Artículo

Use la API de envío del Centro de partners para consultar, crear envíos y publicar ofertas de Azure mediante programación. Esta API es útil si su cuenta administra muchas ofertas y desea automatizar y optimizar el proceso de envío de estas ofertas.

Requisitos previos de la API

Para usar la API del Centro de partners para los productos de Azure necesita algunos recursos de programación:

  • una aplicación de Microsoft Entra.
  • un token de acceso de Microsoft Entra.

Paso 1: Completar los requisitos previos para usar la API de envío del Centro de partners

Antes de empezar a escribir código para llamar a la API de envío del Centro de partners, asegúrese de que ha completado los siguientes requisitos previos.

Asociación de una aplicación de Microsoft Entra con su cuenta del Centro de partners

Para usar la API de envío de Microsoft Store, debes asociar una aplicación de Microsoft Entra a tu cuenta del Centro de partners, recuperar el identificador de inquilino y el identificador de cliente de la aplicación y generar una clave. La aplicación Microsoft Entra representa la aplicación o el servicio desde el que quiere llamar a la API de envío del Centro de partners. Necesita el identificador de inquilino, el identificador de cliente y la clave para obtener un token de acceso de Microsoft Entra que pase a la API.

Nota:

Solo tiene que realizar esta operación una vez. Después de tener el identificador de inquilino, el identificador de cliente y la clave, puede reutilizarlos cada vez que necesite crear un nuevo token de acceso de Microsoft Entra.

  1. En el Centro de partners, asocie la cuenta del Centro de partners de su organización con el directorio Microsoft Entra de la organización.
  2. A continuación, en la página Usuarios de la sección Configuración de la cuenta del Centro de partners, agregue la aplicación Microsoft Entra que representa la aplicación o el servicio que usará para acceder a los envíos de su cuenta del Centro de partners. Asegúrese de asignar a esta aplicación el rol Administrador. Si la aplicación aún no existe en el directorio de Microsoft Entra, puede crear una nueva aplicación de Microsoft Entra en el Centro de partners.
  3. Vuelva a la página Usuarios, haga clic en el nombre de la aplicación De Microsoft Entra para ir a la configuración de la aplicación y copie los valores id. de inquilino e Id. de cliente.
  4. Haga clic en Agregar nueva clave. En la pantalla siguiente, copie el valor de Clave. Después de salir de esta página no podrá tener acceso de nuevo a esta información. Para obtener más información, consulte Administrar claves para una aplicación de Microsoft Entra.

Paso 2: Obtener un token de acceso de Microsoft Entra

Antes de llamar a cualquiera de los métodos de la API de envío del Centro de partners, primero debe obtener un token de acceso de Microsoft Entra que pase al encabezado Authorization de cada método de la API. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede actualizarlo para poder seguir utilizándolo en llamadas futuras a la API.

Para obtener el token de acceso, siga las instrucciones de Llamadas entre servicios mediante las credenciales del cliente para enviar una HTTP POST al punto de conexión https://login.microsoftonline.com/<tenant_id>/oauth2/token. Esta es una solicitud de ejemplo:

JSONCopy

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource= https://api.partner.microsoft.com

Para el valor tenant_id en el POST URI y los parámetros client_id y client_secret, especifique el identificador de inquilino, el identificador de cliente y la clave de la aplicación que recuperó del Centro de partners en la sección anterior. Para el parámetro resource, tiene que especificar https://api.partner.microsoft.com.

Paso 3: Usar la API de envío de Microsoft Store

Después de tener un token de acceso de Microsoft Entra, puede llamar a métodos en la API de envío del Centro de partners. Para crear o actualizar envíos, normalmente se llama a varios métodos en la API de envío del Centro de partners en un orden específico. Para obtener información acerca de cada escenario y la sintaxis de cada método, consulte el Swagger de la API de ingesta.

https://ingestionapi-swagger.azureedge.net/#/

Pasos siguientes