Что такое Push-токены?
Push-токены — это уникальные идентификаторы, которые Apple Push Notification Service (APNS) или Firebase Cloud Messaging (FCM) назначают каждому установленному приложению на устройстве. Эти токены необходимы для отправки целевых push-уведомлений мобильным приложениям.
Типы Push-токенов
APNS (Apple Push Notification Service) iOS push-токены представляют собой 64-байтовые шестнадцатеричные строки, генерируемые серверами Apple. Каждый токен уникален для комбинации приложения, устройства и окружения (sandbox/production).
FCM (Firebase Cloud Messaging) Android push-токены (также называемые registration tokens) генерируются инфраструктурой Firebase от Google. Они обычно выглядят как длинные буквенно-цифровые строки.
VoIP Push-токены Специальные токены, используемые iOS-приложениями для звонков (WhatsApp, Telegram) для высокоприоритетных push-уведомлений, которые мгновенно пробуждают приложение при входящем вызове.
Зачем нужен Push Token API?
Генерация push-токенов в масштабе требует реального взаимодействия с устройствами — их нельзя просто создать программно. Push Token API сервис REGHelp берёт на себя сложную инфраструктуру:
- Управление реальными устройствами — поддержание пулов iOS и Android устройств
- Актуальность токенов — токены истекают и должны регулярно обновляться
- Высокая доступность — время ответа менее 2 секунд с аптаймом 99.9%
- Массовая генерация — сотни токенов в минуту
Как работает Push Token API от REGHelp
Все запросы к REGHelp API используют метод GET с apiKey в query-параметрах:
Шаг 1 — Создание задачи:
GET https://api.reghelp.net/push/getToken?apiKey=ВАШ_КЛЮЧ&appName=tgiOS&appDevice=iOS
Ответ:
{
"id": "664462c0f45c5b1b760b7c3e",
"service": "tg",
"product": "push",
"price": 0.75,
"balance": 122.50,
"status": "success"
}
Шаг 2 — Получение результата:
GET https://api.reghelp.net/push/getStatus?apiKey=ВАШ_КЛЮЧ&id=664462c0f45c5b1b760b7c3e
Ответ (готово):
{
"id": "664462c0f45c5b1b760b7c3e",
"status": "done",
"token": "1673463060517848736:APA91b...",
"message": "OK"
}
Для VoIP Push токенов используйте /pushVoip/getToken по тому же паттерну.
Лучшие практики интеграции
- Кэшируйте токены — сохраняйте полученные токены и используйте их до истечения срока
- Обрабатывайте ошибки — реализуйте повторные попытки с экспоненциальной задержкой
- Мониторьте использование — отслеживайте потребление API через дашборд
- Используйте вебхуки — добавьте параметр
webHookдля получения результатов через POST callback - Rate limiting — соблюдайте лимиты API на ключ
Безопасность Push-токенов
Push-токены следует рассматривать как конфиденциальные данные. Никогда не раскрывайте их в клиентском коде или публичных репозиториях. Всегда передавайте токены через HTTPS и храните их зашифрованными.
Ценообразование
REGHelp использует модель оплаты за использование. Каждая успешная генерация push-токена стоит небольшую сумму, списываемую с вашего баланса. Текущие тарифы смотрите на странице баланса.