Envío directo
Envía una notificación directamente a un identificador de dispositivo (un token válido expresado por el tipo de notificación ). Los usuarios de esta API no necesitan usar registros ni instalaciones. En su lugar, administra todos los dispositivos por sí mismos y usa Azure Notification Hubs únicamente como un servicio de paso a través para comunicarse con los distintos servicios de notificaciones push.
Importante
Firebase Cloud Messaging (FCM) es un servicio que, entre otras cosas, facilita a los desarrolladores el envío de notificaciones push a dispositivos Android compatibles con Google Play. Azure Notification Hubs se comunica actualmente con FCM mediante el protocolo HTTP heredado. FCM v1 es una API actualizada que ofrece más funciones y capacidades. Google anunció que está dejando de utilizar el protocolo HTTP heredado de FCM y que dejará de prestarle soporte el 20 de junio de 2024. Por lo tanto, los desarrolladores que utilicen Azure Notification Hubs para comunicarse con dispositivos Android compatibles con Google Play en la actualidad tendrán que migrar sus aplicaciones y cargas útiles de notificación al nuevo formato. Azure Notification Hubs seguirá siendo compatible con HTTP heredado de FCM hasta que Google deje de aceptar solicitudes. Una vez que se complete la nueva integración de FCM, Azure Notification Hubs anunciará cuándo se puede empezar a migrar. Para más información, consulte los pasos de migración en este artículo.
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?direct&api-version=2015-04 |
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 | Establezca el encabezado Content-Type basado en el servicio de notificación de la plataforma de destino:
|
| ServiceBusNotification-DeviceHandle | Identificador del dispositivo PNS. |
| ServiceBusNotification-Tags | {identificador de etiqueta única} (opcional) |
| ServiceBusNotification-Format | Establezca en uno de los siguientes valores válidos de PlatformType: windows, apple, gcmwindowsphone, adm, , nokiax.baidu |
| x-ms-version | 2015-04 (compatible con 2015-01 y versiones posteriores) |
Cuerpo de la solicitud
En función del tipo de plataforma, el cuerpo de la solicitud da formato a los cambios. Consulte los formatos de cuerpo de cada plataforma individual en las API REST de envío nativas.
- Envío de una notificación nativa de APNS
- Envío de una notificación nativa de FCM
- Envío de una notificación nativa de GCM
- Envío de una notificación nativa de MPNS
- Envío de una notificación nativa de WNS
Response
La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta. El cuerpo de la respuesta se devuelve correctamente.
Códigos de respuesta
| Código | Descripción |
|---|---|
| 201 | 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 tener más de 64 Kb. |
Para obtener información sobre los códigos de estado, vea Códigos de estado y error.
Encabezados de respuesta
Cuando se usa HTTP 1.1, los comentarios de PNS no funcionan al usar la autenticación basada en certificados; no devuelve ningún dato. Use la autenticación basada en tokens.
| Encabezado de respuesta | Descripción |
|---|---|
| Content-Type | application/xml; charset=utf-8 |
| Location | Este encabezado solo está disponible para Notification Hubs de nivel Estándar. Este encabezado contiene el identificador del mensaje de notificación. Se usa con telemetría por mensaje: obtener telemetría de mensajes de notificación y correlacionar los 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.