Метод getMyShortDescription

Описание

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$apiUrl = "https://api.telegram.org/bot{$botToken}/";

// Пример 1: Получение короткого описания для конкретного языка
$languageCode = 'en'; // Английский язык
$params = [
    'language_code' => $languageCode
];

$ch = curl_init($apiUrl . 'getMyShortDescription');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $params,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: multipart/form-data']
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['ok']) {
    echo "Короткое описание для языка {$languageCode}: " . $result['result']['short_description'] . PHP_EOL;
} else {
    echo "Ошибка: " . $result['description'] . PHP_EOL;
}

// Пример 2: Получение короткого описания без указания языка (используется язык по умолчанию)
$params = []; // Пустой массив - язык не указан

$ch = curl_init($apiUrl . 'getMyShortDescription');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $params,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: multipart/form-data']
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['ok']) {
    echo "Короткое описание по умолчанию: " . $result['result']['short_description'] . PHP_EOL;
}

// Пример 3: Использование с библиотекой Guzzle (альтернативный вариант)
/*
use GuzzleHttp\Client;

$client = new Client();
$response = $client->post($apiUrl . 'getMyShortDescription', [
    'form_params' => [
        'language_code' => 'ru' // Русский язык
    ]
]);

$result = json_decode($response->getBody(), true);
*/

// Пример 4: Функция-обертка для удобного использования
function getBotShortDescription($botToken, $languageCode = '') {
    $apiUrl = "https://api.telegram.org/bot{$botToken}/getMyShortDescription";
    
    $params = [];
    if (!empty($languageCode)) {
        $params['language_code'] = $languageCode;
    }
    
    $ch = curl_init($apiUrl);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ['Content-Type: multipart/form-data']
    ]);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}

// Использование функции-обертки
$result = getBotShortDescription($botToken, 'es'); // Для испанского языка
if ($result['ok']) {
    echo "Описание на испанском: " . $result['result']['short_description'] . PHP_EOL;
}

?>

python

import requests

def get_my_short_description(token, language_code=None):
    """
    Получает краткое описание бота для указанного языка.
    
    Args:
        token (str): Токен бота
        language_code (str, optional): Двухбуквенный код языка ISO 639-1. По умолчанию None.
    
    Returns:
        dict: Ответ от Telegram API
    """
    url = f"https://api.telegram.org/bot{token}/getMyShortDescription"
    
    params = {}
    if language_code:
        params['language_code'] = language_code
    
    response = requests.get(url, params=params)
    return response.json()

# Пример использования
if __name__ == "__main__":
    # Замените 'YOUR_BOT_TOKEN' на реальный токен вашего бота
    BOT_TOKEN = 'YOUR_BOT_TOKEN'
    
    # Получение краткого описания для языка по умолчанию
    result = get_my_short_description(BOT_TOKEN)
    print(f"Описание по умолчанию: {result}")
    
    # Получение краткого описания для конкретного языка
    result_ru = get_my_short_description(BOT_TOKEN, language_code='ru')
    print(f"Описание на русском: {result_ru}")
    
    result_en = get_my_short_description(BOT_TOKEN, language_code='en')
    print(f"Описание на английском: {result_en}")

История изменений

• API 6.6. Добавлен метод getMyShortDescription

Дополнительно

• BotShortDescription - Объект, содержащий краткое описание бота для отображения в интерфейсе Telegram.