Enviar uma notificação nativa do MPNS (Microsoft Push Notification Service)

Artigo
05/26/2023

Envia uma notificação nativa do MPNS por meio de um hub de notificação.

Importante

O MPNS (Serviço de Notificação por Push da Microsoft) foi preterido e não tem mais suporte.

Solicitação

Método	URI da solicitação	Versão de HTTP
POST	`https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01`	HTTP/1.1

Cabeçalhos da solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Autorização	Token SAS gerado conforme especificado na Autenticação de Assinatura de Acesso Compartilhado com o Barramento de Serviço.
Tipo de conteúdo	Defina como `application/xml;charset=utf-8`.
ServiceBusNotification-Tags	`{single tag identifier}` (opcional)
ServiceBusNotification-Format	Definida como `windowsphone`
X-*	Todos os cabeçalhos que começam com X- serão encaminhados para o MPNS. Confira Notificações por push para Windows Phone 8.

Corpo da solicitação

O corpo da solicitação é um documento XML , conforme especificado pelo MPNS. Se a notificação for uma notificação bruta, o corpo será qualquer texto de até 1 Kb. Por exemplo:

<?xml version="1.0" encoding="utf-8"?>
<wp:Notification xmlns:wp="WPNotification" Version="2.0">
  <wp:Tile Id="[Tile ID]" Template="IconicTile">
    <wp:SmallIconImage [Action="Clear"]>[small Tile size URI]</wp:SmallIconImage>
    <wp:IconImage Action="Clear">[medium/wide Tile size URI]</wp:IconImage>
    <wp:WideContent1 Action="Clear">[1st row of content]</wp:WideContent1>
    <wp:WideContent2 Action="Clear">[2nd row of content]</wp:WideContent2>
    <wp:WideContent3 Action="Clear">[3rd row of content]</wp:WideContent3>
    <wp:Count Action="Clear">[count]</wp:Count>
    <wp:Title Action="Clear">[title]</wp:Title>
    <wp:BackgroundColor Action="Clear">[hex ARGB format color]</wp:BackgroundColor>
  </wp:Tile>
</wp:Notification>

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código	Descrição
200	Mensagem enviada com êxito.
400	A solicitação está malformada (por exemplo, cabeçalhos de roteamento não válidos, tipo de conteúdo inválido, mensagem excede o tamanho, formato de mensagem inválido).
401	Falha de autorização. A chave de acesso estava incorreta.
403	Cota excedida ou mensagem muito grande; mensagem foi rejeitada.
404	Nenhum branch de mensagem no URI.
413	Entidade solicitada muito grande. O tamanho da mensagem não pode ter mais de 64 Kb.

Para obter informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

Cabeçalho de resposta Descrição

Location

Cabeçalho de resposta	Descrição
Location	Esse cabeçalho só está disponível para Hubs de Notificação da camada Standard. Esse cabeçalho conterá a ID da Mensagem de Notificação. Ele é usado com Obter telemetria de mensagem de notificação e correlacionar comentários PNS. O cabeçalho de local usa o seguinte formato: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Esse cabeçalho só está disponível para Hubs de Notificação da camada Standard.

Esse cabeçalho conterá a ID da Mensagem de Notificação. Ele é usado com Obter telemetria de mensagem de notificação e correlacionar comentários PNS. O cabeçalho de local usa o seguinte formato:

https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04

Corpo da resposta

Nenhum.

Compartilhar via