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 acerca de 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.
  • Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Si el token expira, puedes obtener uno nuevo.

Solicitud

Este método tiene la siguiente sintaxis. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del 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
Authorization string Necesario. Token de acceso de Azure AD con el formato Token de portador<>.

Parámetros de solicitud

Nombre Tipo Descripción Obligatorio
applicationId string El identificador de la Tienda de la aplicación para la que quieres recuperar paquetes piloto. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones. Sí
top int Número de elementos que se devolverán en la solicitud (es decir, el número de paquetes piloto que se devolverán). Si los paquetes piloto de tu cuenta superan el valor especificado en la consulta, el cuerpo de la respuesta incluirá una ruta de acceso al URI relativa que puedes anexar al URI del método para solicitar la siguiente página de datos. No
skip int El número de elementos que se omitirán en la consulta antes de devolver los elementos restantes. Usa este parámetro para consultar conjuntos de datos. Por ejemplo, top = 10 y skip = 0 recuperan los elementos del 1 al 10, mientras que top = 10 y skip = 10 recuperan los elementos del 11 al 20, y así sucesivamente. No

Cuerpo de la solicitud

No incluyas un cuerpo de la solicitud para este método.

Ejemplos de solicitud

En el siguiente ejemplo 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 siguiente ejemplo 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>

Response

En el siguiente ejemplo se muestra el cuerpo de respuesta JSON que devuelve una solicitud correcta para el primer paquete piloto de una aplicación con un total de tres paquetes piloto. Para obtener más información acerca de los valores del cuerpo de respuesta, consulta la siguiente sección.

{
  "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
}

Response body

Valor Tipo Descripción
@nextLink string Si hay páginas adicionales de datos, esta cadena contiene una ruta de acceso relativa que se puede anexar al URI de la solicitud de base https://manage.devcenter.microsoft.com/v1.0/my/ para solicitar la siguiente página de datos. Por ejemplo, si el parámetro top 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 a para solicitar los dos paquetes piloto siguientes.
value array Una matriz de objetos que proporcionan información acerca de los paquetes piloto de la aplicación especificada. Para obtener más información sobre los datos de cada objeto, consulta Recurso de piloto.
totalCount int El número total de filas del resultado de datos de la consulta (es decir, el número total de paquetes piloto de 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.