Быстрый старт

Это руководство поможет вам выполнить первый запрос к API Пачки — от получения токена до создания чата.

Для работы с API нужен аккаунт Пачки с доступом к API (настраивается владельцем пространства) и любой HTTP-клиент — терминал с cURL, Postman или Bruno. Также можно использовать CLI — все методы доступны как команды.

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

Получите токен

Для работы с API вам нужен токен доступа. Есть два способа его получить:

  • Персональный токен — в интерфейсе Пачки: Автоматизации > API (доступно администраторам)
  • Токен бота — создайте бота в Автоматизации > Интеграции > Чат-боты и Вебхуки
Подробнее о типах токенов и скоупах — в разделе Авторизация.

Проверьте токен

Получим информацию о своем профиле — простейший запрос GETИнформация о профиле без параметров:

Получение профиля
curl "https://api.pachca.com/api/shared/v1/profile" \  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Все запросы отправляются на базовый URL https://api.pachca.com/api/shared/v1. Токен передаётся в заголовке Authorization: Bearer TOKEN. Ответ содержит данные в объекте data, а для списочных методов — ещё и блок meta с информацией о пагинации.

Если вместо данных вы получили 401 Unauthorized — проверьте, что токен скопирован без лишних пробелов и что у него есть нужный скоуп.

Создайте чат

Теперь создадим закрытый канал. Все параметры — в описании метода POSTНовый чат.

Создание чата
curl "https://api.pachca.com/api/shared/v1/chats" \  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \  -H "Content-Type: application/json" \  -d '{  "chat": {    "name": "🤿 aqua",    "member_ids": [      186,      187    ],    "group_tag_ids": [      86,      18    ],    "channel": true,    "public": false  }}'

Укажите название чата и список участников. Идентификаторы сотрудников можно получить через метод GETСписок сотрудников, а идентификаторы тегов — через метод GETСписок тегов. Запросы с телом отправляются в формате JSON с заголовком Content-Type: application/json.

Следующие шаги