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

  • Статья

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

Запрос

Метод Универсальный код ресурса (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.
ServiceBusNotification-Tags Среда {single tag identifier} (необязательно)
ServiceBusNotification-Format Задайте значение apple.
ServiceBusNotification-Apns-Expiry Истекает срок действия апна в W3C DTF, ГГГГ-ММ-ДДThh:mmTZD (например, 1997-07-16T19:20+01:00).

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

Текст запроса — это XML-документ, указанный Apple. Пример:

    { 
        "aps" : { 
            "alert" : " This is my toast message for iOS!", 
        }, 
    }

Ответ

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

Текст ответа

Нет.

См. также:

Прямая пакетная отправка
Отправка собственного уведомления APNS
Отправка собственного уведомления MPNS
Отправка собственного уведомления WNSОтправка уведомления шаблона