Compartir a través de

Obtener paquetes piloto para una aplicación

  • Artículo

Usa este método en la API de envío de Microsoft Store para enumerar los paquetes piloto de una aplicación registrada en tu cuenta del Centro de partners. Para obtener más información sobre los paquetes piloto, consulta Paquetes piloto.

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}/listflights

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 Obligatorio
applicationId string Id. de la Tienda de la aplicación para la que quieres recuperar los paquetes piloto. Para obtener más información sobre el identificador de la Tienda, consulta Ver los detalles de la identidad de la aplicación. Sí
superior int Número de elementos que se van a devolver en la solicitud (es decir, el número de paquetes piloto que se van a devolver). Si la cuenta tiene más paquetes piloto que el valor especificado en la consulta, el cuerpo de la respuesta incluye una ruta de acceso de URI relativa que puede anexar al URI del método para solicitar la siguiente página de datos. No
skip int Número de elementos que se van a omitir en la consulta antes de devolver los elementos restantes. Use este parámetro para paginar a través de conjuntos de datos. Por ejemplo, top=10 y skip=0 recupera los elementos del 1 al 10, top=10 y skip=10 recupera los elementos de 11 a 20, etc. No

Cuerpo de la solicitud

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

Ejemplos de solicitud

En el ejemplo siguiente se muestra cómo enumerar todos los paquetes piloto de una aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

En el ejemplo siguiente se muestra cómo enumerar el primer paquete piloto de una aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

En el ejemplo siguiente se muestra el cuerpo de respuesta JSON devuelto por una solicitud correcta para el primer paquete piloto para una aplicación con tres paquetes piloto totales. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte la sección siguiente.

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

Cuerpo de la respuesta

Valor Tipo Description
@nextLink string Si hay páginas adicionales de datos, esta cadena contiene una ruta de acceso relativa que puede anexar al URI de solicitud base https://manage.devcenter.microsoft.com/v1.0/my/ para solicitar la siguiente página de datos. Por ejemplo, si el parámetro superior del cuerpo de la solicitud inicial se establece en 2, pero hay 4 paquetes piloto para la aplicación, el cuerpo de la respuesta incluirá un @nextLink valor de applications/{applicationid}/listflights/?skip=2&top=2, que indica que puede llamar https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 para solicitar los 2 paquetes piloto siguientes.
value array Matriz de objetos que proporcionan información sobre paquetes piloto para la aplicación especificada. Para obtener más información sobre los datos de cada objeto, vea Recurso piloto.
totalCount int Número total de filas del resultado de datos de la consulta (es decir, el número total de paquetes piloto para la aplicación especificada).

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 Descripción
404 No se encontró ningún paquete piloto.
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.