Files
MAX/docs/max-api/01-overview.md

12 lines
1.3 KiB
Markdown
Raw Normal View History

# Обзор Max Bot API
Базовый URL: **https://platform-api.max.ru**. Авторизация: заголовок `Authorization: <token>`. Токен через query не поддерживается. Токен берётся в платформе MAX для партнёров: Интеграция → Получить токен.
Коды ответов: 200 — успех; 400 — неверный запрос; 401 — ошибка аутентификации; 404 — не найден; 405 — метод не разрешён; 429 — лимит запросов; 503 — сервис недоступен.
Рекомендации: для разработки — Long Polling (GET /updates), для production — только Webhook. Не более 30 запросов в секунду.
Клавиатура (inline_keyboard): до 210 кнопок, до 30 рядов, до 7 кнопок в ряду. Типы: callback (событие message_callback), link, request_contact, request_geo_location, open_app, message. Для Webhook поддерживается только HTTPS.
Форматирование: в NewMessageBody поле format: markdown или html. Markdown: *курсив*, **жирный**, `код`, [ссылка](url). HTML: теги b, i, del, u, code, a.