Compartir a través de

Obtener un paquete de vuelo

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

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}/flights/{flightId}

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
applicationId cuerda / cadena Obligatorio. El 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 cuerda / cadena Obligatorio. Identificador del vuelo del paquete que se va a obtener. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un vuelo de paquete y obtener vuelos de paquete para una aplicación. Para un vuelo que fue creado en el Partner Center, este identificador también está disponible en la URL de la página de vuelo en el Partner Center.

Cuerpo de la solicitud

No incluya un contenido de la solicitud para este método.

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo recuperar información sobre un vuelo del paquete 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 respuesta

Importancia Tipo Descripción
flightId cuerda / cadena Identificador del paquete de vuelo. Este valor lo proporciona Partner Center.
nombre amistoso cuerda / cadena Nombre del paquete de vuelo, según lo especificado por el desarrollador.
Última Presentación de Vuelo Publicada objeto Objeto que proporciona información sobre el último envío publicado para el vuelo del paquete. Para obtener más información, consulte la sección Objeto de Envío a continuación.
pendienteDeEnvioDeVuelo objeto Un objeto que proporciona información sobre el envío actualmente pendiente para el vuelo del paquete. Para obtener más información, consulte la sección Objeto de Envío a continuación.
identificadores de grupo arreglo Matriz de cadenas que contienen los identificadores de los grupos de vuelo asociados al vuelo de paquete. Para obtener más información sobre los grupos de vuelos, consulta Paquete de vuelos.
rangoMásAltoQue cuerda / cadena El nombre amigable del paquete de vuelos que se clasifica inmediatamente más bajo que el paquete de vuelos actual. Para obtener más información sobre la clasificación de grupos de vuelos, consulte Paquete de vuelos.

Objeto de envío

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

Importancia Tipo Descripción
identificación cuerda / cadena El identificador del envío.
ubicación del recurso cuerda / cadena Ruta de acceso relativa que puede adjuntar al URI de solicitud base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar los datos completos de la presentación.

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
400 La solicitud no es válida.
404 No se encontró el paquete de vuelo especificado.
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.