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