Enviar uma notificação nativa do Serviço de Notificação Push da Microsoft (MPNS)

Artigo
05/26/2023

Envia uma notificação nativa do MPNS através de um hub de notificação.

Importante

O Serviço de Notificação Push da Microsoft (MPNS) foi preterido e já não é suportado.

Pedir

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

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Cabeçalho do pedido	Descrição
Autorização	Token de SAS gerado conforme especificado em Autenticação de Assinatura de Acesso Partilhado com o Service Bus.
Content-Type	Definido como `application/xml;charset=utf-8`.
ServiceBusNotification-Tags	`{single tag identifier}` (opcional)
ServiceBusNotification-Format	Definir como `windowsphone`
X-*	Todos os cabeçalhos a partir de X- serão reencaminhados para MPNS. Veja Notificações Push para Windows Phone 8.

Corpo do pedido

O corpo do pedido é um documento XML , conforme especificado pelo MPNS. Se a notificação for uma notificação não processada, o corpo será qualquer texto 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 estado HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código	Descrição
200	Mensagem enviada com êxito.
400	O pedido é mal formado (por exemplo, cabeçalhos de encaminhamento não válidos, não é válido tipo de conteúdo, a mensagem excede o tamanho, formato de mensagem incorreto).
401	Falha de autorização. A chave de acesso estava incorreta.
403	Quota excedida ou mensagem demasiado grande; a mensagem foi rejeitada.
404	Nenhum ramo de mensagem no URI.
413	Entidade pedida demasiado grande. O tamanho da mensagem não pode ter mais de 64 Kb.

Para obter informações sobre códigos de estado, veja Códigos de Estado e Erro.

Cabeçalhos de resposta

Cabeçalho de resposta Descrição

Localização

Cabeçalho de resposta	Descrição
Localização	Este cabeçalho só está disponível para Hubs de Notificação de escalão Standard. Este cabeçalho irá conter o ID da Mensagem de Notificação. É utilizado com a telemetria Obter mensagens de notificação e correlacionar comentários PNS. O cabeçalho de localização utiliza o seguinte formato: `https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04`

Este cabeçalho só está disponível para Hubs de Notificação de escalão Standard.

Este cabeçalho irá conter o ID da Mensagem de Notificação. É utilizado com a telemetria Obter mensagens de notificação e correlacionar comentários PNS. O cabeçalho de localização utiliza o seguinte formato:

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

Corpo da resposta

Nenhum.

Partilhar via