Compartir a través de

Obtener un paquete piloto

  • Artículo

Usa este método en la API de envío de Microsoft Store para obtener datos de un paquete piloto para una aplicación registrada en tu cuenta del Centro de partners.

Requisitos previos

Para usar este método, primero debes hacer lo siguiente:

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
  • Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. 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 obtener uno nuevo.

Solicitar

Este método tiene la sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones del encabezado y el cuerpo de la solicitud.

Método URI de solicitud
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Nombre Escribir Descripción
applicationId string Necesario. Id. de la Tienda de la aplicación que contiene el paquete piloto que quieres obtener. El identificador de la Tienda de la aplicación está disponible en el Centro de partners.
flightId string Necesario. Identificador del paquete piloto que se va a obtener. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación. Para un vuelo creado en el Centro de partners, este identificador también está disponible en la dirección URL de la página piloto del Centro de partners.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo recuperar información sobre un paquete piloto con el id. 43e448df-97c9-4a43-a0bc-2a445e736bcd para una aplicación con el valor de id. de la Tienda 9WZDNCRD91MD.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte las secciones siguientes.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Cuerpo de la respuesta

Valor Tipo Descripción
flightId string Identificador del paquete piloto. Este valor lo proporciona el Centro de partners.
friendlyName string Nombre del paquete piloto, según lo especificado por el desarrollador.
lastPublishedFlightSubmission objeto Objeto que proporciona información sobre el último envío publicado para el paquete piloto. Para obtener más información, vea la sección Objeto de envío a continuación.
pendingFlightSubmission objeto Objeto que proporciona información sobre el envío pendiente actual para el paquete piloto. Para obtener más información, vea la sección Objeto de envío a continuación.
groupIds array Matriz de cadenas que contienen los identificadores de los grupos piloto asociados al paquete piloto. Para obtener más información sobre los grupos piloto, consulta Paquetes piloto.
rankHigherThan string Nombre descriptivo del paquete piloto que se clasifica inmediatamente más bajo que el paquete piloto actual. Para obtener más información sobre la clasificación de grupos piloto, consulta Paquetes piloto.

Objeto Submission

Los valores lastPublishedFlightSubmission y pendingFlightSubmission del cuerpo de la respuesta contienen objetos que proporcionan información de recursos sobre un envío para el paquete piloto. Estos objetos tienen los valores siguientes.

Valor Tipo Descripción
id string El identificador del envío.
resourceLocation string Ruta de acceso relativa que puede anexar al URI de solicitud base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar los datos completos del envío.

Códigos de error

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.

Código de error Description
400 La solicitud no es válida.
404 No se pudo encontrar la versión piloto del paquete especificado.
409 La aplicación usa una característica del Centro de partners que actualmente no es compatible con la API de envío de Microsoft Store.