Отправка собственного уведомления службы push-уведомлений Windows (WNS)
Отправляет собственное уведомление WNS через центр уведомлений.
Запрос
Метод | Универсальный код ресурса (URI) запроса | параметр "Версия HTTP" |
---|---|---|
POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
HTTP/1.1 |
Заголовки запросов
В следующей таблице перечислены обязательные и необязательные заголовки запросов.
Заголовок запроса | Описание |
---|---|
Авторизация | Маркер SAS, созданный, как указано в разделе Проверка подлинности подписанного URL-адреса с помощью служебной шины. |
Content-Type | Задайте application/json;charset=utf-8 или application/xml . Если тип уведомления (X-WNS-Type ) — wns/raw , задайте для application/octet-stream значение . |
ServiceBusNotification-Tags | Среда {single tag identifier} (необязательно) |
ServiceBusNotification-Format | Установите значение windows |
X-WNS- | Все заголовки, начиная с X-WNS, будут перенаправляться в WNS. |
Текст запроса
Текст запроса — это XML-документ, указанный в WNS. Если уведомление имеет тип "wns/raw", текстом будет любой текст размером до 5 КБ. Пример:
<?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>
Ответ
Ответ включает код состояния HTTP и набор заголовков ответа.
Коды ответов
Код | Описание |
---|---|
200 | Сообщение успешно отправлено. |
400 | Запрос имеет неправильный формат (например, недопустимые заголовки маршрутизации, недопустимый тип содержимого, размер сообщения превышается, неправильный формат сообщения). |
401 | Ошибка авторизации. Указана неправильная клавиша доступа. |
403 | Превышена квота или сообщение слишком велико; сообщение было отклонено. |
404 | Отсутствует ветвь сообщения по универсальному коду ресурса (URI). |
413 | Запрошенная сущность слишком велика. Размер сообщения не может быть более 64 КБ. |
Дополнительные сведения о кодах состояния см. в разделе Коды состояния и ошибок.
Заголовки ответов
Заголовок ответа | Описание |
---|---|
Расположение | Этот заголовок доступен только для Центров уведомлений уровня "Стандартный". Этот заголовок будет содержать идентификатор сообщения уведомления. Он используется для телеметрии каждого сообщения и корреляцииобратной связи PNS. Заголовок location имеет следующий формат: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 |
Текст ответа
Нет.