Отправка собственного уведомления службы push-уведомлений Майкрософт (MPNS)

  • Статья

Отправляет собственное уведомление MPNS через центр уведомлений.

Важно!

Служба push-уведомлений (Майкрософт) (MPNS) устарела и больше не поддерживается.

Запрос

Метод Универсальный код ресурса (URI) запроса Версия HTTP
POST https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 HTTP/1.1

Заголовки запросов

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

Заголовок запроса Описание
Авторизация Маркер SAS, созданный, как указано в разделе Проверка подлинности подписанного URL-адреса с помощью служебной шины.
Content-Type Задайте значение application/xml;charset=utf-8.
ServiceBusNotification-Tags Среда {single tag identifier} (необязательно)
ServiceBusNotification-Format Установите значение windowsphone
X-* Все заголовки, начинающиеся с X-, будут переадресованы в MPNS. См. раздел Push-уведомления для Windows Phone 8.

Текст запроса

Текст запроса — это XML-документ, указанный в MPNS. Если уведомление является необработанным, текст содержит любой текст размером до 1 КБ. Пример:

<?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>

Ответ

Ответ включает код состояния 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

Текст ответа

Нет.

См. также: