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