Действие ListEndpointsByPlatformApplication
Получает список эндпоинтов для Push-уведомлений.
HTTP-запрос
POST https://notifications.yandexcloud.net/
Query-параметры
Параметр | Описание |
---|---|
Action |
string Обязательное поле. Параметр для обозначения типа операции. Значение: ListEndpointsByPlatformApplication . |
PlatformApplicationArn |
string Обязательное поле. Идентификатор канала мобильных Push-уведомлений. Пример: arn:aws:sns::aoegtvhtp8ob********:app/GCM/test-cns-9990 . |
NextToken |
string Токен для просмотра записей об эндпоинтах после первой страницы. |
ResponseFormat |
string Формат ответа. Возможные значения:
|
Ответ
Успешный ответ
При отсутствии ошибок Cloud Notification Service отвечает HTTP-кодом 200
.
Успешный ответ содержит дополнительные данные в формате XML или JSON в зависимости от указанного параметра ResponseFormat
.
Схема данных:
<?xml version="1.0" encoding="UTF-8"?>
<ListEndpointsByPlatformApplicationResponseXML>
<ResponseMetadata>
<RequestId>string</RequestId>
</ResponseMetadata>
<ListEndpointsByPlatformApplicationResult>
<Endpoints>
<member>
<EndpointArn>string</EndpointArn>
<Attributes>
<entry>
<key>string</key>
<value>string</value>
</entry>
</Attributes>
</member>
</Endpoints>
<NextToken>string</NextToken>
</ListEndpointsByPlatformApplicationResult>
</ListEndpointsByPlatformApplicationResponseXML>
{
"ResponseMetadata": {
"RequestId": "string"
},
"ListEndpointsByPlatformApplicationResult": {
"Endpoints": [
{
"EndpointARN": "string",
"Attributes": {
"Attribute": "string"
}
}
],
"NextToken": "string"
}
}
Где:
-
RequestId
— идентификатор запроса. -
EndpointArn
— идентификатор (ARN) мобильного эндпоинта. -
Attributes
— атрибуты мобильного эндпоинта. Поддерживается вывод следующих атрибутов:CustomUserData
— прочие пользовательские данные, которые хранятся вместе с эндпоинтом. Cloud Notification Service никак не использует эти данные.Enabled
— атрибут для включение и выключение уведомлений в эндпоинт, в настоящее время не поддерживается. Всегда возвращается значениеtrue
.
Примечание
Вывод атрибута
Token
не осуществляется для дополнительной защиты данных. -
NextToken
— токен для просмотра записей об эндпоинтах на следующей странице. Возвращается, когда доступны дополнительные записи. Если все записи были просмотрены,NextToken
не возвращается.
Ответ с ошибкой
При возникновении ошибки Cloud Notification Service отвечает сообщением с соответствующим HTTP-кодом.
Перечень общих кодов ошибок для всех действий см. в разделе Ошибки.