- register_max_webhook.py, fetch_schema.py - n8n-code-node-max-normalize.js (max_id, callback из callback.user, contact из vcf_info) - n8n-code-add-menu-buttons.js (меню с callback, request_contact, Главное меню) - docs: max-webhook, max-curl-http-request, max-api (форматы, кнопки, контакт), clpr vs sprf - README, SITUATION, схемы sprf_ и clpr_, .gitignore Co-authored-by: Cursor <cursoragent@cursor.com>
1.3 KiB
Обзор 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: курсив, жирный, код, ссылка. HTML: теги b, i, del, u, code, a.