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

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

Messaging API v2

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

Notify	Создает и отправляет одно сообщение через любой канал. Заменяет /createMessage, /createTargetedMessage, /createEmailMessage, /createSMSMessage, /createKakaoMessage.

Messages API

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

Presets API

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

Device API

registerDevice	Регистрирует устройство для приложения.
unregisterDevice	Удаляет push-токен устройства.
deleteDevice	Удаляет устройство и все связанные с ним данные в указанном приложении.
setTags	Устанавливает значения тегов для устройства.
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	Создает тег в вашем аккаунте.
deleteTag	Удаляет тег со всей связанной информацией.
listTags	Получает список тегов в аккаунте.

Segmentation (Filters) API

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

User-centric API

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

Events API

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

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

Статистика сообщений

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

Статистика приложений и подписчиков

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

Статистика кампаний

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

Статистика событий и тегов

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

iOS Live Activities API

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

Customer Journey API

Get Journey stats	Получает статистику для определенного Journey по его ID.
Remove users from journeys	Удаляет одного или нескольких пользователей из всех или выбранных активных Journey.

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