Действие CreatePlatformEndpoint
Статья создана
Обновлена 3 апреля 2025 г.
Создает эндпоинт для Push-уведомлений (подписывает пользователя на Push-уведомления).
HTTP-запрос
POST https://notifications.yandexcloud.net/
Query-параметры
| Параметр | Описание |
|---|---|
Action |
string Обязательное поле. Параметр для обозначения типа операции. Значение: CreatePlatformEndpoint. |
PlatformApplicationArn |
string Обязательное поле. Идентификатор канала мобильных Push-уведомлений или Push-уведомлений в браузере. Пример: arn:aws:sns::aoegtvhtp8ob********:app/GCM/test-cns-9990. |
Token |
string Обязательное поле. Для мобильных уведомлений — уникальный токен на устройстве пользователя (Registration ID), созданный сервисом уведомлений для приложения. Для уведомлений в браузере — объект PushSubscription в формате JSON, который получен в браузере пользователя. |
CustomUserData |
string Прочие пользовательские данные, которые можно сохранить вместе с эндпоинтом. Cloud Notification Service никак не использует эти данные. |
ResponseFormat |
string Формат ответа. Возможные значения:
|
Ответ
Успешный ответ
При отсутствии ошибок Cloud Notification Service отвечает HTTP-кодом 200.
Успешный ответ содержит дополнительные данные в формате XML или JSON в зависимости от указанного параметра ResponseFormat.
Схема данных:
XML
JSON
<?xml version="1.0" encoding="UTF-8"?>
<CreatePlatformEndpointResponse>
<ResponseMetadata>
<RequestId>string</RequestId>
</ResponseMetadata>
<EndpointArn>string</EndpointArn>
</CreatePlatformEndpointResponse>
{
"ResponseMetadata": {
"RequestId": "string"
},
"EndpointArn": "string"
}
Где:
RequestId— идентификатор запроса.EndpointArn— идентификатор (ARN) мобильного эндпоинта.
Ответ с ошибкой
При возникновении ошибки Cloud Notification Service отвечает сообщением с соответствующим HTTP-кодом.
Перечень общих кодов ошибок для всех действий см. в разделе Ошибки.