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