Какую задачу решает Telegram Premium API?
В проектах, которые продают или дарят Telegram Premium, главная сложность — выполнять заказ быстро и без ошибок. Ручной выбор срока, сравнение цены и отправка платежа требуют и времени, и внимания.
Premium API объединяет эти шаги в один поток: принимается username, выбирается срок, берётся актуальная цена, и оплата автоматически проводится с баланса проекта.
Поддерживаемые сроки
API работает с вариантами подарка Premium на 3, 6 и 12 месяцев. Это охватывает самые востребованные пакеты для реселлеров и ботов.
Цену можно заранее получить через отдельный эндпоинт, поэтому клиенту легко показать точную стоимость каждого пакета до заказа.
- Telegram Premium на 3 месяца
- Telegram Premium на 6 месяцев
- Telegram Premium на 12 месяцев
- Автоматический заказ через REST JSON
Поток заказа и эндпоинты
Разработчик сначала получает API-ключ в проекте и настраивает баланс. Затем бот или бэкенд отправляет запросы к эндпоинтам Fragment-API.uz с заголовком X-API-Key.
Цены доступных пакетов возвращает /api/v1/premium/pricing, а /api/v1/premium/buy выполняет заказ по username и сроку. Для предварительной проверки получателя используется /api/v1/getInfo.
Все ответы имеют одинаковую структуру — ok, message, code и result, — поэтому обработка успешных и ошибочных случаев простая.
Безопасность и контроль
Каждый проект отделён своим API-ключом, поэтому потоки разных клиентов не смешиваются. В панели управления видны баланс, количество заказов и статистика расходов.
Секретные эндпоинты API закрыты от поисковых роботов, а открытая документация и страницы статей оставлены доступными для индексации.
Начало интеграции
Самый короткий путь: зарегистрируйтесь, создайте проект, получите API-ключ и настройте баланс. Затем последовательно подключите эндпоинты получения цены и выполнения заказа.
Примеры запросов, ответов и cURL уже готовы в документации /api, поэтому первый заказ можно протестировать за несколько минут.
Частые вопросы
Какие сроки поддерживает Telegram Premium API?
API работает с пакетами Telegram Premium на 3, 6 и 12 месяцев.
Можно ли заранее получить цены Premium?
Да. Эндпоинт Premium pricing возвращает актуальные цены по доступным пакетам, поэтому клиенту можно заранее показать стоимость.
Как проходит оплата?
Оплата автоматически списывается с баланса проекта. Для выполнения заказа на балансе должно быть достаточно средств.
Где виден статус заказа?
Заказы записываются в статистику панели проекта, а в ответе API возвращается код успеха или ошибки.
Можно ли заранее проверить пользователя?
Да. Через эндпоинт getInfo можно до заказа проверить, существует ли получатель с таким username.