Obtener paquetes de vuelos para una aplicación

2025-06-10

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

Prerrequisitos

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

Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Solicitud

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	Solicitud de URI
OBTENER	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights`

Cabecera de solicitud

Cabecera	Tipo	Descripción
Autorización	cuerda / cadena	Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Nombre	Tipo	Descripción	Obligatorio
applicationId	cuerda / cadena	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í
Parte superior	Int	Número de elementos que se van a devolver en la solicitud (es decir, el número de vuelos de paquete que se van a devolver). Si tu cuenta tiene más vuelos de paquetes que el valor especificado en la consulta, el cuerpo de la respuesta incluye una ruta de acceso URI relativa que puedes anexar al URI del método para solicitar la siguiente página de datos.	No
saltarse	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 incluya un contenido de la solicitud para este método.

Solicitudes de ejemplo

En el ejemplo siguiente se muestra cómo enumerar todos los vuelos de paquete 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 listar el primer lanzamiento de paquete para 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 respuesta

Importancia	Tipo	Descripción
@nextLink	cuerda / cadena	Si hay páginas adicionales de datos, esta cadena contiene una ruta de acceso relativa que puede adjuntar a la URI base de la solicitud `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 de vuelo para la aplicación, el cuerpo de la respuesta incluirá un valor @nextLink de `applications/{applicationid}/listflights/?skip=2&top=2`, lo que indica que puede llamar a `https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2` para solicitar los 2 paquetes de vuelo siguientes.
valor	arreglo	Conjunto de objetos que proporcionan información sobre vuelos de paquetes para la aplicación especificada. Para obtener más información sobre los datos de cada objeto, consulte el recurso de vuelo .
conteo total	Int	Número total de filas en el resultado de datos de la consulta (es decir, el número total de vuelos de paquetes 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 encontraron vuelos en paquete.
409	La aplicación usa una característica del Centro de asociados que actualmente no es compatible con la API de envío de Microsoft Store.

Compartir a través de