Отправка собственного уведомления службы 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

Текст ответа

Нет.

См. также: