Метод getUserChatBoosts

Метод для получения списка бустов, добавленных конкретным пользователем в чат, требующий прав администратора.

Описание

Используйте этот метод, чтобы получить список бустов, добавленных пользователем в чат. Требуются права администратора в чате. Возвращает объект 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 - Объект содержит список бустов чата, добавленных конкретным пользователем.
Комментарии