Для разработчиков

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

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

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

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

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

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

  • Персональный токен — в интерфейсе Пачки: Интеграции > API. Кому доступна эта страница, решает владелец пространства
  • Токен бота — создайте бота в Интеграции > Боты и выпустите токен на вкладке API его карточки, или программно методом POSTНовый бот
Подробнее о типах токенов и скоупах — в разделе Авторизация. Если бот должен работать с данными сотрудников их правами, используйте авторизацию от имени сотрудника.

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

Получим информацию о своем профиле — простейший запрос 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 YOUR_ACCESS_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  }}'

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

Выберите путь работы с API

Если нужен типизированный клиент — SDK для TypeScript, Python, Go, Kotlin, Swift и C#.