Envío de una notificación nativa del Servicio de notificaciones push de Microsoft (MPNS)
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.