Compartilhar via

Obter um pacote de viagem

Use este método na API de envio da Microsoft Store para obter dados de um vôo de pacote para um aplicativo registrado em sua conta do Centro de Parceiros.

Pré-requisitos

Para usar esse método, primeiro você precisa fazer o seguinte:

  • Se você ainda não fez isso, conclua todos os pré-requisitos para a API de envio da Microsoft Store.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para esse método. Depois de obter um token de acesso, você terá 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.

Solicitação

Esse método tem a sintaxe a seguir. Consulte as seções a seguir para obter exemplos de uso e descrições do corpo do cabeçalho e da solicitação.

Método URI de solicitação
OBTER https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização cadeia de caracteres Obrigatório O token de acesso do Azure AD no formato Bearer<token>.

Parâmetros de solicitação

Nome Tipo Descrição
ID do aplicativo cadeia de caracteres Obrigatório O ID da loja do aplicativo que contém o pacote de pré-lançamento que você deseja obter. O ID da Store para o aplicativo está disponível no Partner Center.
ID do voo cadeia de caracteres Obrigatório O ID do pacote de voo a ser obtido. Este ID está disponível nos dados de resposta para solicitações para criar um voo de pacote e obter voos de pacote para um aplicativo. Para um voo criado no Partner Center, esse ID também está disponível na URL para a página de voo no Partner Center.

Corpo da solicitação

Não forneça um corpo de solicitação para este método.

Exemplo de solicitação

O exemplo a seguir demonstra como recuperar informações sobre um "package flight" do pacote com o ID 43e448df-97c9-4a43-a0bc-2a445e736bcd para um aplicativo com o valor do ID da Loja 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>

Resposta

O exemplo a seguir demonstra o corpo da resposta JSON de uma chamada bem-sucedida a este método. Para obter mais detalhes sobre os valores no corpo da resposta, consulte as seções a seguir.

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

Corpo da resposta

Valor Tipo Descrição
ID do voo cadeia de caracteres O ID do voo do pacote. Esse valor é fornecido pelo Partner Center.
nome amigável cadeia de caracteres O nome do pacote de voo, conforme especificado pelo desenvolvedor.
últimaSubmissãoDeVooPublicada objeto Um objeto que fornece informações sobre o último envio publicado para o voo de pacote. Para obter mais informações, consulte a seção objeto Submission abaixo.
envio de voo pendente objeto Um objeto que fornece informações sobre a submissão pendente atual do voo do pacote. Para obter mais informações, consulte a seção objeto Submission abaixo.
IDs de grupo matriz Uma matriz de cadeias de caracteres que contêm as IDs dos grupos de voo associados ao voo do pacote. Para obter mais informações sobre grupos de voo, consulte pacotes de voos .
classificarMaisAltoQue cadeia de caracteres O nome amigável do voo de pacote que é classificado imediatamente abaixo do voo de pacote atual. Para obter mais informações sobre a classificação de grupos de voos, consulte Pacote de voos.

Objeto de Submissão

Os valores lastPublishedFlightSubmission e pendingFlightSubmission no corpo da resposta contêm objetos que fornecem informações de recurso sobre uma submissão para o pacote de voo. Esses objetos têm os seguintes valores.

Valor Tipo Descrição
id cadeia de caracteres O ID do envio.
localizaçãoDoRecurso cadeia de caracteres Um caminho relativo que você pode acrescentar ao URI base da solicitação https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar todos os dados da submissão.

Códigos de erro

Se a solicitação não puder ser concluída com êxito, a resposta conterá um dos seguintes códigos de erro HTTP.

Código do erro Descrição
400 A solicitação é inválida.
404 Não foi possível encontrar o pacote de voo especificado.
409 O aplicativo usa um recurso do Partner Center que atualmente não é suportado pela API de submissão da Microsoft Store.