giftPremiumSubscription
Дарує підписку Telegram Premium.
Повертає: У разі успіху повертає True.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
user_id | Integer | Так | ID користувача |
month_count | Integer | Так | Кількість місяців (1, 3, 6 або 12) |
star_count | Integer | Так | Ціна в Stars: 1000 за 3 місяці, 1500 за 6 місяців, 2500 за 12 місяців |
text | String | Ні | Текст повідомлення (0-255) |
text_parse_mode | String | Ні | Режим розмітки тексту |
text_entities | Array of MessageEntity | Ні | JSON-масив MessageEntity |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/giftPremiumSubscription" \
-H "Content-Type: application/json" \
-d '{"user_id":123456789,"month_count":3,"star_count":100}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/giftPremiumSubscription",
json={
"user_id": 123456789,
"month_count": 3,
"star_count": 100
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/giftPremiumSubscription`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"user_id": 123456789,
"month_count": 3,
"star_count": 100
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
sendInvoiceНадсилає рахунок на оплату.createInvoiceLinkСтворює посилання на оплату.refundStarPaymentПовертає платіж у Telegram Stars.sendGiftНадсилає подарунок користувачеві або в чат.getMyStarBalanceПовертає баланс Telegram Stars бота.getStarTransactionsПовертає транзакції Telegram Stars бота.editUserStarSubscriptionСкасовує або поновлює підписку в Telegram Stars.answerShippingQueryВідповідає на запит щодо доставки.answerPreCheckoutQueryВідповідає на запит перед оплатою (pre-checkout).getAvailableGiftsПовертає подарунки, які бот може надіслати.getUserGiftsПовертає подарунки користувача.getChatGiftsПовертає подарунки чату.