Обзор Pushwoosh API

Pushwoosh API позволяет разработчикам взаимодействовать с платформой Pushwoosh.

С помощью Pushwoosh API вы получаете доступ к обширной библиотеке из более чем 100 методов, которые позволяют вам:

• Отправлять персонализированные push-уведомления
• Создавать, импортировать, экспортировать и управлять пользовательскими сегментами для точного таргетинга
• Использовать bulk API для пакетного управления пользователями/устройствами
• Настраивать приложения
• Отслеживать события пользователей и добавлять теги пользователям для улучшения таргетинга и персонализации
• Создавать и управлять сущностями Pushwoosh, такими как пресеты, теги, события, приложения и т. д.
• Запускать Customer Journeys в Pushwoosh через API
• Получать подробную статистику по Customer Journeys и кампаниям push-уведомлений/email/SMS.
• Реализовывать геофенсинг для отправки уведомлений на основе местоположения, когда пользователи входят в определенные географические зоны или покидают их
• Бесшовно интегрировать сторонние сервисы с Pushwoosh

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

Pushwoosh API использует токены API для аутентификации запросов. Существует два типа токенов: серверные и устройств, каждый из которых используется для определенных областей действия API.

Каждая учетная запись Pushwoosh поставляется с токеном доступа API по умолчанию, созданным для демо-приложения Pushwoosh. Вы можете просматривать, создавать и управлять своими токенами API в панели управления Pushwoosh.

Ограничение по частоте запросов (rate limit) — это количество запросов, которое API может получить за определенный период. Хотя большинство запросов к API в Pushwoosh не ограничены, для запросов к API /createMessage установлено ограничение в 600 запросов в минуту для обеспечения качества обслуживания для всех пользователей.

Для всех запросов к API обязательно использование HTTPS, что обеспечивает безопасную передачу данных.

Pushwoosh API обычно возвращает ответы в формате JSON.

Когда ваш запрос к API обработан успешно, вы получите код успешной операции в составе ответа.

Обратите внимание, что получение ответа HTTP 200 означает, что ваш запрос был понят и успешно обработан, но это не гарантирует успешности самого действия. Поэтому обязательно проверяйте наличие сообщений об ошибках или предупреждений (доступ запрещен, приложение не найдено, недействительный ключ API и т. д.), чтобы определить, было ли действие успешным.

В случае если ваш запрос неправильно отформатирован, возникли проблемы с его обработкой или любые другие ошибки, Pushwoosh отправит вам код ошибки, указывающий на характер проблемы. Это поможет вам эффективно диагностировать и устранить неполадку.