pachca-profile

Base URL: https://api.pachca.com/api/shared/v1 Авторизация: Authorization: Bearer <ACCESS_TOKEN> Токен: бот (Автоматизации → Интеграции → API) или пользователь (Автоматизации → API). Если токен неизвестен — спроси у пользователя перед выполнением запросов.

Когда использовать

• получить профиль
• мой профиль
• установить статус
• обновить статус
• сбросить статус
• кастомные поля
• дополнительные поля

Когда НЕ использовать

• найти сотрудника, создать пользователя, список сотрудников → pachca-users
• создать канал, создать беседу, создать чат → pachca-chats
• отправить сообщение, ответить в тред, прикрепить файл → pachca-messages
• настроить бота, вебхук, webhook → pachca-bots
• показать форму, интерактивная форма, модальное окно → pachca-forms
• создать задачу, список задач, напоминание → pachca-tasks
• поиск сообщений, найти сообщение, полнотекстовый поиск → pachca-search
• аудит, журнал событий, безопасность → pachca-security

Пошаговые сценарии

Установить статус

1. PUT /profile/status с emoji и title
2. Чтобы включить режим «Нет на месте» — добавь is_away: true
3. Чтобы задать сообщение о недоступности — добавь away_message: "текст" (макс 1024 символа, отображается в профиле и при личных сообщениях/упоминаниях)

curl -X PUT "https://api.pachca.com/api/shared/v1/profile/status" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":{"emoji":"🏖️","title":"В отпуске до 10 марта","is_away":true,"away_message":"Я в отпуске. По срочным вопросам — @ivanov"}}'

Сбросить статус

1. DELETE /profile/status

curl -X DELETE "https://api.pachca.com/api/shared/v1/profile/status" \
  -H "Authorization: Bearer $TOKEN"

Получить кастомные поля профиля

1. GET /custom_properties?entity_type=User — список дополнительных полей для сотрудников (id, name, data_type)
2. GET /profile — в ответе поле custom_properties содержит значения для текущего пользователя

Параметр entity_type=User фильтрует поля по типу сущности. Кастомные поля настраиваются администратором пространства. Значения хранятся в массиве custom_properties объекта user.

Обработка ошибок

Доступные операции

Список дополнительных полей

GET /custom_properties

скоуп: custom_properties:read

Информация о токене

GET /oauth/token/info

Информация о профиле

GET /profile

скоуп: profile:read

Текущий статус

GET /profile/status

скоуп: profile_status:read

Новый статус

PUT /profile/status

скоуп: profile_status:write

{
  "status": {
    "emoji": "",
    "title": ""
  }
}

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

DELETE /profile/status

скоуп: profile_status:write

Ограничения и gotchas

• status.away_message: максимум 1024 символов
• Пагинация: cursor-based (limit + cursor), НЕ page-based

Подробнее

см. references/endpoints.md