getBusinessAccountGifts
Повертає подарунки бізнес-акаунта.
Повертає: У разі успіху повертає OwnedGifts.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
business_connection_id | String | Так | ID бізнес-підключення |
exclude_unsaved | Boolean | Ні | Виключити подарунки, не збережені на сторінці профілю |
exclude_saved | Boolean | Ні | Виключити подарунки, збережені на сторінці профілю |
exclude_unlimited | Boolean | Ні | Виключити подарунки, які можна купити необмежену кількість разів |
exclude_limited_upgradable | Boolean | Ні | Виключити лімітовані подарунки, які можна перетворити на унікальні |
exclude_limited_non_upgradable | Boolean | Ні | Виключити лімітовані подарунки, які не можна перетворити на унікальні |
exclude_unique | Boolean | Ні | Виключити унікальні подарунки |
exclude_from_blockchain | Boolean | Ні | Виключити подарунки з блокчейну TON |
sort_by_price | Boolean | Ні | Сортувати за ціною подарунка, а не за датою надсилання |
offset | String | Ні | Зсув для пагінації |
limit | Integer | Ні | Кількість (1-100) |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/getBusinessAccountGifts" \
-H "Content-Type: application/json" \
-d '{"business_connection_id":"BUSINESS_CONNECTION_ID"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/getBusinessAccountGifts",
json={
"business_connection_id": "BUSINESS_CONNECTION_ID"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/getBusinessAccountGifts`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"business_connection_id": "BUSINESS_CONNECTION_ID"
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
getBusinessAccountStarBalanceПовертає баланс Stars бізнес-акаунта.transferBusinessAccountStarsПереказує Stars із бізнес-акаунта на баланс бота.readBusinessMessageПозначає вхідне повідомлення прочитаним від імені бізнес-акаунта.deleteBusinessMessagesВидаляє повідомлення від імені бізнес-акаунта.setBusinessAccountNameЗмінює ім’я бізнес-акаунта.setBusinessAccountUsernameЗмінює username бізнес-акаунта.setBusinessAccountBioЗмінює біографію бізнес-акаунта.setBusinessAccountProfilePhotoВстановлює фото профілю бізнес-акаунта.removeBusinessAccountProfilePhotoВидаляє фото профілю бізнес-акаунта.setBusinessAccountGiftSettingsЗмінює налаштування подарунків бізнес-акаунта.deleteBusinessAccountGiftВидаляє звичайний подарунок бізнес-акаунта без отримання Stars (Bot API 10.4).