Справочник по методам API

Pushwoosh предоставляет обширную библиотеку из более чем 100 методов API, разделенных по категориям для различных функций, таких как отправка уведомлений, управление пользователями и отслеживание аналитики.

Messaging API v2

Унифицированный API, заменяющий все семейство методов /create*Message (push, email, SMS, Kakao). См. обзор и руководство по миграции.

Notify	Создает и отправляет одно сообщение через любой канал. Заменяет /createMessage, /createTargetedMessage, /createEmailMessage, /createSMSMessage, /createKakaoMessage.
Cancel	Отменяет ранее созданное сообщение до его доставки. Используется с message_code из метода Notify.
Update	Заменяет еще не отправленное запланированное сообщение новым определением (полная замена). Используется с message_code из метода Notify.

SMTP gateway

Отправляйте транзакционные email по стандартному протоколу SMTP вместо прямого вызова API. Шлюз аутентифицируется с помощью кода вашего приложения и токена API, а затем пересылает каждое сообщение в метод Notify. См. справочник по SMTP-шлюзу.

Messages API

createMessage Устарел	Создает новое push-уведомление. Вместо него используйте Notify.
deleteMessage	Удаляет запланированное сообщение.
getMessageDetails	Получает детали сообщения.
createTargetedMessage Устарел	Создает новое целевое push-уведомление. Вместо него используйте Notify с типом transactional.
getPushHistory Устарел	Используйте /messages:list для получения истории сообщений с подробными данными.
cancelMessage	Отменяет запланированное сообщение.

Presets API

createPreset	Создает новый пресет (Preset).
getPreset	Получает параметры указанного push-пресета.
listPresets	Получает список пресетов, созданных для приложения.
deletePreset	Удаляет пресет из вашего аккаунта.

Device API

registerDevice	Регистрирует устройство для приложения.
unregisterDevice	Удаляет push-токен устройства.
deleteDevice	Удаляет устройство и все связанные с ним данные в указанном приложении.
setTags	Устанавливает значения тегов (Tags) для устройства.
getTags	Получает теги с их соответствующими значениями для определенного устройства.
setBadge	Отправляет текущее значение значка (badge) для устройства в Pushwoosh.
applicationOpen	Регистрирует событие открытия приложения.
pushStat	Регистрирует событие открытия push-уведомления.
messageDeliveryEvent	Регистрирует событие доставки push-уведомления для устройства.

Audience API

bulkSetTags	Устанавливает значения тегов для нескольких устройств.
bulkSetTags Status	Возвращает статус операции bulkSetTags.
bulkRegisterDevice	Регистрирует несколько устройств в одном запросе, включая необязательные значения тегов для каждого устройства.
bulkRegisterDevice Status	Получает статус и результаты запроса на массовую регистрацию устройств по ID запроса.
bulkUnregisterDevice	Отменяет регистрацию нескольких устройств в одном запросе.
bulkUnregisterDevice Status	Получает статус и результаты запроса на массовую отмену регистрации устройств по ID запроса.

Tags API

addTag	Создает тег (Tag) в вашем аккаунте.
deleteTag	Удаляет тег со всей связанной информацией.
listTags	Получает список тегов в аккаунте.

Segmentation (Filters) API

createFilter	Создает новый сегмент (Segment).
listFilters	Возвращает список доступных сегментов с их условиями.
deleteFilter	Удаляет существующий сегмент.
exportSegment	Планирует запрос на экспорт подписчиков, соответствующих условиям сегмента.
exportSegment Results	Получает CSV-ссылку на результаты exportSegment.

User-centric API

registerUser	Связывает внешний User ID с указанным устройством.
deleteUser	Удаляет пользователя и все устройства, связанные с указанным User ID.
postEvent	Вызывает событие (Event) в приложении.

Events API

createEvent	Создает событие (Event) для приложения.

Applications API

createApplication	Создает новое приложение в аккаунте.
updateApplication	Обновляет настройки приложения.
deleteApplication	Удаляет приложение из аккаунта.
getApplication	Получает подробную информацию о приложении.
getApplications	Получает список приложений в аккаунте.
getApplicationFile	Получает файлы конфигурации, связанные с приложением.
setApplicationPlatformStatus	Изменяет статус платформы для приложения.

Campaigns API

createCampaign	Создает новую push-кампанию.
deleteCampaign	Удаляет определенную кампанию.
getCampaigns	Получает список кампаний для приложения.

App configuration API

configureApplication for iOS	Настраивает платформу iOS для приложения.
configureApplication for Android	Настраивает платформу Android для приложения.
configureApplication for Mac OS X	Настраивает платформу macOS для приложения.
configureApplication for Windows	Настраивает платформу Windows для приложения.
configureApplication for Amazon	Настраивает платформу Amazon для приложения.
configureApplication for Chrome	Настраивает платформу Chrome для приложения.
configureApplication for Safari	Настраивает платформу Safari для приложения.
configureApplication for Firefox	Настраивает платформу Firefox для приложения.
configureApplication for Email	Настраивает платформу Email для приложения.

Email API

createEmailMessage Устарел	Создает email-сообщение. Вместо него используйте Notify с platforms: ["EMAIL"] и email_payload.
registerEmail	Регистрирует email-адрес для приложения.
deleteEmail	Удаляет email-адрес из вашей базы данных.
setEmailTags	Устанавливает значения тегов для указанного email-адреса.
registerEmailUser	Связывает внешний User ID с указанным email-адресом.

Test devices API

createTestDevice	Регистрирует тестовое устройство для приложения.
listTestDevices	Получает все тестовые устройства, зарегистрированные для приложения.

Message inbox API

getInboxMessages	Получает список сообщений Inbox для указанного HWID.
inboxStatus	Обновляет статус определенного сообщения Inbox.

Statistics API

Message statistics

messages:list	Получает список отправленных сообщений.
totalsByIntervals	Предоставляет метрики и данные о конверсиях, сгруппированные по часам.
getMessageLog	Получает подробную информацию об отправленных сообщениях.
linksInteractions	Предоставляет статистику по кликам на ссылки в email.
linksInteractionsDevices	Перечисляет пользователей, которые кликнули на ссылки в email.
bouncedEmails	Предоставляет информацию о возвратах (bounces) email, жалобах и причинах возвратов.

Application and subscriber statistics

getApplicationSubscribersStats	Получает статистику подписчиков приложения, сгруппированную по типу устройства.
getAppStats	Получает статистику приложения за определенный период времени.
getSubscribersStatistics	Получает статистику подписчиков за определенный период времени.

Campaign statistics

getCampaignStats	Получает статистику кампании за определенный период времени.

Events and tags statistics

getEventStatistics	Получает количество срабатываний события за определенный период.
getTagStats	Получает статистику по определенному тегу.

iOS Live Activities API

startLiveActivity	Создает новую iOS Live Activity.
updateLiveActivity	Обновляет существующую iOS Live Activity.

Apple Wallet PassKit API

Apple Wallet PassKit API	Справочник по управлению картами Apple Wallet и связанной конфигурацией в Pushwoosh.

Google Wallet API

Create a pass	Создает карту в Google Wallet и возвращает ссылку для сохранения.
Validate a pass	Проверяет конфигурацию карты без ее создания.
Update a pass	Обновляет существующую карту. Google доставляет изменения на сохраненные устройства.
Get a save link	Возвращает ссылку “Добавить в Google Wallet” для сохранения существующей карты.
Get a pass	Возвращает одну сохраненную карту.
List passes	Возвращает постраничный список карт для приложения.
Set pass state	Активирует или делает недействительной карту.
Delete a pass	Делает карту недействительной в Google и удаляет ее запись в Pushwoosh.
Get configuration	Возвращает состояние конфигурации Google Wallet для приложения.
Templates	Перечисляет шаблоны карт или извлекает один из них в качестве отправной точки.

Customer Journey API

Lifecycle	Запускает, приостанавливает, завершает, сохраняет в черновики или архивирует Journey по его UUID.
Create and update	Создает новое определение Journey или заменяет существующее.
Start by API	Добавляет пользователей в точку входа API запущенного Journey.
Get Journey stats	Получает статистику для определенного Journey по его ID.
Remove users from journeys	Удаляет одного или нескольких пользователей из всех или выбранных активных Journeys.

Scheduled requests API

getResults	Получает результат запланированного запроса.

SMS API

createSMSMessage Устарел	Создает новое SMS-сообщение. Вместо него используйте Notify с platforms: ["SMS"].

WhatsApp API

createWhatsAppMessage Устарел	Создает новое сообщение WhatsApp. Вместо него используйте Notify с platforms: ["WHATS_APP"].

LINE API

createLineMessage Устарел	Создает новое сообщение LINE. Вместо него используйте Notify с platforms: ["LINE"].

Kakao API

createKakaoMessage Устарел	Отправляет сообщение Kakao, используя утвержденный шаблон. Вместо него используйте Notify с platforms: ["KAKAO"].

Geozones API

getNearestZone	Получает параметры ближайшей геозоны и расстояние до нее. Также записывает местоположение устройства для гео-push-уведомлений.
addGeoZone	Добавляет геозону в определенное приложение.
updateGeoZone	Обновляет свойства геозоны, такие как имя, статус, контент и радиус действия.
deleteGeoZone	Удаляет геозоны из приложения.
addGeoZoneCluster	Добавляет кластер геозон в приложение.
deleteGeoZoneCluster	Удаляет кластер геозон из приложения.
listGeoZones	Получает список геозон для приложения.
listGeoZoneClusters	Получает список кластеров геозон для приложения.