API и интеграции

Первый запрос к REST API

Проверка GET /me, правильный Bearer-заголовок и импорт актуального контракта API платформы 1.1.1.

Обновлено 22.08.2026
Время чтения 11 мин
Сложность Средний
Цель инструкции

Получить первый ответ 200 и открыть методы API без ручного набора адресов.

Короткий маршрут

Что вы сделаете

Откройте нужный шаг сразу или идите по порядку. Проверка результата остаётся в самой инструкции.

  1. 01 Первый запрос
  2. 02 Импорт в Postman
  3. 03 Почему возможны 401 и 403
  4. 04 Удаление теста

Результат: сервер вернёт контекст ключа и организации, а методы появятся в Postman из канонического OpenAPI.

Что понадобится

  • Ключ из предыдущей инструкции.
  • Сервер, терминал или защищённая среда Postman.
  • Базовый адрес https://telegram.appsmax.ru/api/v1.

Первый запрос

export APPSMAX_API_TOKEN='сохранённое_значение'
curl --fail-with-body \
  -H "Authorization: Bearer $APPSMAX_API_TOKEN" \
  -H "Accept: application/json" \
  https://telegram.appsmax.ru/api/v1/me

Ожидайте HTTP 200, JSON с организацией, правами и фактическим ограничением запросов, а также заголовок X-Request-Id. Не публикуйте сам ответ, если в нём есть внутренние идентификаторы.

Форма проверки сохранённого ключа API платформы
Сначала проверьте ключ в кабинете и добейтесь ответа 200 от /me. Только затем переходите к бизнес-объектам.

Импорт в Postman

  1. Откройте технический справочник REST API.
  2. Скачайте OpenAPI JSON или Postman collection.
  3. В Postman выберите Import и укажите файл.
  4. Создайте private environment.
  5. Сохраните base URL и токен в secret-переменной.
  6. Выполните GET /me.
Документация платформы с OpenAPI и Postman collection
Версия контракта — 1.1.1. Ссылка /developers/openapi.json является канонической для REST API.

Почему возможны 401 и 403

401 относится к аутентификации: проверьте Bearer, пробел и актуальность ключа. 403 означает, что ключ распознан, но права недостаточны. Не добавляйте все права автоматически — выдайте конкретное право.

Удаление теста

Команда GET /me ничего не создаёт. Удалите токен из истории команд, если вставляли значение напрямую, и храните его только в secret store.

Дальше: выберите n8n, Битрикс24 или нужную REST-инструкцию.

Нужна помощь с запуском?

Если не хочется разбираться самостоятельно, мы можем помочь. Поможем настроить платформу под вашу задачу и быстрее запустить проект без лишних шагов.