MAX API выглядит как Telegram. Пока не начнёшь писать код Коллеги, документация MAX API — это одно, а реальность — совсем другое. 5 граблей, на которые я наступил.
ВК позиционирует MAX API как "аналог Telegram Bot API". Методы похожие, структуры JSON знакомые.
Но дьявол в деталях. За 2 недели разработки собрал коллекцию различий, которых нет в документации.
Грабли #1: Auth через query params
В Telegram: Authorization: Bot TOKEN в headers.
В MAX: токен в URL как query parameter.
javascript
// Не работает
fetch('/api/method', { headers: { 'Authorization': 'Bot ' + token } })
// Работает
fetch('/api/method?access_token=' + token)
Грабли #2: Нет show_alert в answerCallbackQuery
В Telegram можно показать popup с текстом.
В MAX : только уведомление или ничего. Флаг show_alert игнорируется.
Грабли #3: 403 при публикации в канал Бот может читать из канала, но не может писать. Даже с admin правами. Решение: только через аккаунт создателя канала.
Грабли #4: bot_started.user вместо /start
В Telegram: команда /start.
В MAX: event bot_started с объектом user.
Грабли #5: answerCallback ≠ answerCallbackQuery
В MAX метод называется answerCallback, не answerCallbackQuery.
Мелочь, но ломает копипаст из Telegram ботов.
Кстати про MAX и его 89М аудитории я уже писал.
Больше технических решений в бесплатном гиде
#моикейсы_поповвии Работаем дальше.
Больше AI-автоматизации в бесплатном гиде. Подписывайтесь на канал @popovvii — делюсь кейсами и инструментами для автоматизации бизнеса.