Obter o status de um envio de pacote de pré-lançamento
Use esse método na API de envio da Microsoft Store para obter o status de um envio de pacote de pré-lançamento. Para obter mais informações sobre o processo de criação de um envio de pacote de pré-lançamento usando a API de envio da Microsoft Store, consulte Gerenciar envios de pacote de pré-lançamento.
Pré-requisitos
Para usar este método, primeiro você precisa fazer o seguinte:
- Se você ainda não tiver feito 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. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.
- Crie um envio de pacote de pré-lançamento para um de seus aplicativos. Você pode fazer isso no Partner Center ou pode fazer isso usando o método de envio de criação de um pacote de pré-lançamento .
Solicitar
Esse método tem a seguinte sintaxe. Consulte as seções a seguir para obter exemplos de uso e descrições do cabeçalho e do corpo da solicitação.
| Método | URI da solicitação |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status |
Cabeçalho da solicitação
| Cabeçalho | Tipo | Descrição |
|---|---|---|
| Autorização | string | Obrigatório. O token de acesso do Azure AD no Token<de portador> do formulário. |
Parâmetros da solicitação
| Nome | Tipo | Descrição |
|---|---|---|
| applicationId | string | Obrigatória. A ID da Loja do aplicativo que contém o envio de pacote de pré-lançamento para o qual você deseja obter o status. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo. |
| ID do voo | string | Obrigatória. A ID do pacote de pré-lançamento que contém o envio para o qual você deseja obter o status. Essa ID está disponível nos dados de resposta para solicitações para criar um pacote de pré-lançamento e obter pacotes de pré-lançamento para um aplicativo. Para um voo criado no Partner Center, essa ID também está disponível na URL da página de voo no Partner Center. |
| submissionId | string | Obrigatória. A ID do envio para o qual você deseja obter o status. Essa ID está disponível nos dados de resposta para solicitações para criar um envio de pacote de pré-lançamento. Para um envio criado no Partner Center, essa ID também está disponível na URL da página de envio no Partner Center. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Exemplo de solicitação
O exemplo a seguir demonstra como obter o status de um envio de pacote de pré-lançamento.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/status HTTP/1.1
Authorization: Bearer <your access token>
Resposta
O exemplo a seguir demonstra o corpo da resposta JSON para uma chamada bem-sucedida para esse método. O corpo da resposta contém informações sobre o envio especificado. Para obter mais detalhes sobre os valores no corpo da resposta, consulte a seção a seguir.
{
"status": "PendingCommit",
"statusDetails": {
"errors": [],
"warnings": [],
"certificationReports": []
},
}
Corpo da resposta
| Valor | Type | Descrição |
|---|---|---|
| status | string | O status do envio. Esse valor pode ser um dos seguintes:
|
| statusDetails | objeto | Contém detalhes adicionais sobre o status do envio, incluindo informações sobre quaisquer erros. Para obter mais informações, consulte Recurso de detalhes do status. |
Códigos do 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 |
|---|---|
| 404 | Não foi possível encontrar o pedido. |
| 409 | O aplicativo usa um recurso do Partner Center que atualmente não é compatível com a API de envio da Microsoft Store. |