Wiki
猫Recipes RU
English version: Recipes
Это краткая русскоязычная версия страницы с практическими рецептами. Полная и наиболее актуальная страница: Recipes.
Зачем нужна эта страница
Если основные страницы объясняют модель библиотеки, то recipes показывают короткие копируемые паттерны для типовых задач.
Полезные сценарии
Admin-only command
Используй middleware плагина или middleware команды, если команда должна быть доступна только ограниченной группе пользователей.
Поток callback
Комбинируй:
NewInlineKeyboard(...)- обработчик данных callback;
AnswerCallback...;EditCallback(...)
Long reply
Если текст может быть длинным, используй AnswerLong(...) или KeyboardLong(...), а не обычный Answer(...).
Localized command
Подключи L10n к bot и используй ctx.Translate(...) внутри handler'ов.
Обработчик обновлений вне команд
Для inline_query, poll, chat_member и других update types используй AddUpdateHandler(...).
Поток на основе черновиков
Если ответ строится постепенно, начни с ctx.NewDraft().
Upload через tgapi
Когда нужны multipart uploads или более низкоуровневые file API, выходи в tgapi.
Строгий режим данных callback
Если несовпадение формата данных callback должно считаться ошибкой, включай SetStrictPayloadType(true).
Как использовать recipes правильно
Recipes хороши как стартовые шаблоны, но не заменяют более подробные страницы про:
- жизненный цикл;
- middleware;
- модель данных callback;
- тестирование.
Что читать дальше
Navigation
Start here
Runtime and Architecture
- Bot-Lifecycle
- Webhook-Runtime
- Middleware
- Runners
- Error-Handling
- Logging
- Update-Routing-Model
- Policies
- Scenes
Interaction and Telegram API
- Inline-Keyboards-and-Payloads
- Auto-Generated-Commands
- Drafts
- Rich-Messages
- Localization
- Rate-Limiting
- tgapi-Overview