Описание
Используйте этот метод, чтобы получить список бустов, добавленных пользователем в чат. Требуются права администратора в чате. Возвращает объект UserChatBoosts.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat_id | Целое число или Строка | Да | Уникальный идентификатор чата или имя пользователя канала (в формате @channelusername) |
| user_id | Целое число | Да | Уникальный идентификатор целевого пользователя |
Примеры
php
<?php
// Токен вашего бота
$botToken = 'YOUR_BOT_TOKEN';
// Параметры запроса
$chatId = '@channelusername'; // или числовой ID чата
$userId = 123456789; // ID пользователя
// URL для вызова метода
$apiUrl = "https://api.telegram.org/bot{$botToken}/getUserChatBoosts";
// Подготовка данных
$postData = [
'chat_id' => $chatId,
'user_id' => $userId
];
// Инициализация cURL
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json'
]);
// Выполнение запроса
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
// Обработка ответа
if ($response === false) {
echo 'Ошибка cURL: ' . curl_error($ch);
} else {
$decodedResponse = json_decode($response, true);
if ($decodedResponse['ok']) {
$userChatBoosts = $decodedResponse['result'];
// Пример обработки результата
echo "Количество бустов: " . count($userChatBoosts['boosts']) . "\n";
foreach ($userChatBoosts['boosts'] as $boost) {
echo "ID буста: " . $boost['boost_id'] . "\n";
echo "Дата добавления: " . date('Y-m-d H:i:s', $boost['add_date']) . "\n";
echo "Дата истечения: " . date('Y-m-d H:i:s', $boost['expiration_date']) . "\n";
echo "---\n";
}
} else {
echo "Ошибка API: " . $decodedResponse['description'] . "\n";
}
}
// Закрытие соединения
curl_close($ch);
// Альтернативный вариант с использованием file_get_contents
/*
$context = stream_context_create([
'http' => [
'method' => 'POST',
'header' => 'Content-Type: application/json',
'content' => json_encode($postData)
]
]);
$response = file_get_contents($apiUrl, false, $context);
$decodedResponse = json_decode($response, true);
if ($decodedResponse['ok']) {
// Обработка успешного ответа
print_r($decodedResponse['result']);
}
*/
?>
python
import requests
def get_user_chat_boosts(bot_token, chat_id, user_id):
"""
Получает список бустов, добавленных пользователем в чат.
Args:
bot_token (str): Токен вашего бота
chat_id (int or str): ID чата или username канала
user_id (int): ID пользователя
Returns:
dict: Ответ от Telegram API в формате JSON
"""
url = f"https://api.telegram.org/bot{bot_token}/getUserChatBoosts"
params = {
"chat_id": chat_id,
"user_id": user_id
}
response = requests.post(url, json=params)
return response.json()
# Пример использования
if __name__ == "__main__":
# Замените значения на реальные
BOT_TOKEN = "YOUR_BOT_TOKEN"
CHAT_ID = -1001234567890 # ID чата или "@channelusername"
USER_ID = 123456789 # ID пользователя
result = get_user_chat_boosts(BOT_TOKEN, CHAT_ID, USER_ID)
print(result)
История изменений
- API 7.0. Добавлен метод getUserChatBoosts
Дополнительно
- UserChatBoosts - Объект содержит список бустов чата, добавленных конкретным пользователем.