Права и лимиты
Токен получает только выбранные права и отдельную допустимую частоту запросов.
Разработчикам
API начинается с ограниченного токена и проверки ping
В кабинете можно создать ключ только с нужными правами, скачать описание OpenAPI и набор запросов Postman, выполнить проверку и увидеть результат в журнале.
Реальный интерфейс 320appsдемонстрационные данные
Открыть крупно ↗Документация, доступ и проверка собраны в кабинете
API для разработчиков · тестовый проектСоздайте отдельный ключ, возьмите актуальную схему запросов и начните с проверки, которая не меняет данные.
Технический контур
Контракт, доступ и наблюдаемость рядом
API 320apps предназначен для связи вашей серверной системы с платформой. Это не официальный API MAX.
API§P◎ ⌁≡
REST API v1
Документированные JSON-запросы к разрешённым данным организации, ботов, мини-приложений, сценариев и заявок.
Открыть API →OpenAPI JSON
Актуальная схема запросов и примеры ответов скачиваются в разделе API кабинета.
Открыть документацию →Коллекция Postman
Готовый набор запросов строится из той же актуальной схемы API.
Открыть экспорт →Уведомления о событиях
Для событий используйте отдельный HTTPS-адрес и проверяйте тестовую доставку.
Как это работает →Журнал запросов
Статус и request id помогают сопоставить вызов со своей диагностикой без логирования секретов.
Понятный маршрут
Первый запрос
Точные адреса, названия заголовков запроса и примеры берите из OpenAPI в кабинете — так интеграция не разойдётся с действующей версией API.
- 01
Создайте токен
Дайте ему понятное имя, выберите только необходимые права и допустимую частоту запросов.
- 02
Сохраните секрет один раз
Не коммитьте его, не помещайте в браузерный код и не отправляйте в поддержку.
- 03
Проверьте /ping
Убедитесь, что токен принят, затем выполните один запрос без изменения данных.
- 04
Сверьте журнал
После теста проверьте статус, время и X-Request-Id в кабинете.
Короткие ответы
Что обычно уточняют
Сначала — прямой ответ. Подробности можно открыть только там, где они нужны.
Где скачать OpenAPI и Postman?
В разделе «API и интеграции» кабинета my.320apps.ru. Обе выгрузки строятся из одного актуального описания API.
Можно использовать токен в JavaScript на сайте?
Нет. API предназначен для связи серверов. Секретный токен нельзя отдавать браузеру.
Как найти причину неуспешного запроса?
Сохраните время, статус и X-Request-Id из ответа, затем найдите запись с тем же идентификатором в журнале кабинета. Секретный токен в лог добавлять нельзя.
↗Открыть API
Следующий шаг
Начните с проверки без изменения данных
Создайте ключ с минимальными правами, проверьте ping и один GET-запрос — только затем расширяйте доступ.