Envío de una notificación nativa del Servicio de notificaciones push de Windows (WNS)
Envía una notificación nativa de WNS mediante un centro de notificaciones.
Solicitud
| Método | URI de solicitud | Versión de 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 | Se establece en application/json;charset=utf-8 o application/xml. Si el tipo de notificación (X-WNS-Type) es wns/raw, establezca en application/octet-stream. |
| ServiceBusNotification-Tags |
{single tag identifier} (opcional) |
| ServiceBusNotification-Format | Establézcala en windows |
| X-WNS- | Todos los encabezados que empiecen por X-WNS se reenviarán a WNS. |
Cuerpo de la solicitud
El cuerpo de la solicitud es un documento XML especificado por WNS. Si la notificación es de tipo "wns/raw", el cuerpo es cualquier texto de hasta 5 Kb. Por ejemplo:
<?xml version="1.0" encoding="utf-8" ?>
<toast>
<visual lang="en-US">
<binding template="ToastText01">
<text id="1">
This is my toast message for Win8!
</text>
</binding>
</visual>
</toast>
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 por mensaje y la 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.