Compartir a través de

Envío de una notificación nativa del Servicio de notificaciones push de Microsoft (MPNS)

  • Artículo

Envía una notificación nativa de MPNS mediante un centro de notificaciones.

Importante

El Servicio de notificaciones push de Microsoft (MPNS) está en desuso y ya no se admite.

Solicitud

Método URI de solicitud Versión HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Token de SAS generado tal y como se especifica en Autenticación de firma de acceso compartido con Service Bus.
Content-Type Establézcalo en application/xml;charset=utf-8.
ServiceBusNotification-Tags {single tag identifier} (opcional)
ServiceBusNotification-Format Establézcala en windowsphone
X-* Todos los encabezados que empiecen por X- se reenviarán a MPNS. Consulte Notificaciones push para Windows Phone 8.

Cuerpo de la solicitud

El cuerpo de la solicitud es un documento XML especificado por MPNS. Si la notificación es una notificación sin procesar, el cuerpo es cualquier texto de hasta 1 Kb. Por ejemplo:

<?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>

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Códigos de respuesta

Código Descripción
200 Mensaje enviado correctamente.
400 La solicitud es incorrecta (por ejemplo, encabezados de enrutamiento no válidos, tipo de contenido no válido, el mensaje supera el tamaño, formato de mensaje incorrecto).
401 Error de autorización. La clave de acceso era incorrecta.
403 Cuota superada o mensaje demasiado grande; mensaje rechazado.
404 No hay ramificación de mensaje en el URI.
413 Entidad solicitada demasiado grande. El tamaño del mensaje no puede ser superior a 64 Kb.

Para obtener información sobre los códigos de estado, vea Códigos de estado y error.

Encabezados de respuesta

Encabezado de respuesta Descripción
Location Este encabezado solo está disponible para Notification Hubs de nivel Estándar.

Este encabezado contendrá el identificador del mensaje de notificación. Se usa con la telemetría De obtención de mensajes de notificación y correlación de comentarios de PNS. El encabezado de ubicación usa el siguiente formato:

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

Response body

Ninguno.

Consulte también