Результат: вы построите карту доступной организации и найдёте идентификаторы для следующих запросов.
Порядок чтения
GET /me— контекст ключа, scopes и лимит.GET /organizations— текущая организация.GET /bots— доступные боты.GET /bots/{bot}— выбранный бот.GET /bots/{bot}/connections— его подключения.GET /miniapps— мини-приложения.GET /funnels— сценарии.GET /interactive-menu— элементы меню.
Вместе с GET /ping это девять безопасных read-only операций обзорного маршрута.
Минимальные права API
| Объект | Право API |
|---|---|
| Организация | organizations:read |
| Боты | bots:read |
| Подключения | connections:read |
| Мини-приложения | miniapps:read |
| Сценарии | funnels:read |
| Меню | interactive_menu:read |
Пример
curl --fail-with-body \
-H "Authorization: Bearer $APPSMAX_API_TOKEN" \
"https://telegram.appsmax.ru/api/v1/bots?page=1&per_page=20"Не подбирайте ID последовательным перебором. Используйте только идентификаторы из ответа доступной организации. Любой список может иметь пагинацию.
Проверка
Сохраните локальную карту organization → bot → connections без токена. Сверьте названия с кабинетом. При 404 проверьте организацию и выбранный ID; при 403 — конкретное право чтения.
Дальше: используйте найденный bot_id в инструкциях по заявкам или подписчикам.
Если не хочется разбираться самостоятельно, мы можем помочь. Поможем настроить платформу под вашу задачу и быстрее запустить проект без лишних шагов.