Obter o status de uma submissão de complemento

2025-06-10

Utilize esse método na API de envio da Microsoft Store para obter o status de um envio de complemento (também conhecido como IAP ou produto dentro do aplicativo). Para obter mais informações sobre o processo de criação de um envio de complemento usando a API de envio da Microsoft Store, consulte Gerenciar envios de complemento.

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.
Crie uma submissão de complemento para um de seus aplicativos. Você pode fazer isso no Partner Center ou, alternativamente, você pode usar o método Criar uma submissão de complemento.

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/inappproducts/{inAppProductId}/submissions/{submissionId}/status`

Cabeçalho da solicitação

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

Parâmetros de solicitação

Nome	Tipo	Descrição
ID do Produto In-App	corda	Obrigatório A ID da Loja do complemento que contém o envio para o qual você deseja obter o status. O ID da Loja está disponível na Central de Parceiros.
ID de submissão	corda	Obrigatório 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 uma submissão de complemento. Para um envio criado no Partner Center, essa ID também está disponível na URL para a página de envio 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 verificar o status de uma submissão de complemento.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/status 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. O corpo da resposta contém informações sobre a submissão especificada. Para obter mais detalhes sobre os valores no corpo da resposta, consulte as seções a seguir.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Corpo da resposta

Valor	Tipo	Descrição
estado	corda	A situação do envio. Esse valor pode ser um dos seguintes: Nenhum Cancelado CompromissoPendente Comprometimento Iniciado Falha na submissão Publicação Pendente Publicação Publicado Falha na publicação Pré-processamento Falha no pré-processamento Certificação Falha na certificação Liberação Falha no lançamento
detalhes do status	objeto	Contém detalhes adicionais sobre o status do envio, incluindo informações sobre erros. Para obter mais informações, consulte o recurso de detalhes de status .

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
404	Não foi possível encontrar o envio.
409	O complemento usa um recurso do Partner Center que atualmente não tem suporte da API de envio da Microsoft Store.

Compartilhar via