pachca-profile

https://api.pachca.com/api/shared/v1

Authorization: Bearer <ACCESS_TOKEN>

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

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

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

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

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

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

1. PUT /profile/status с

   emoji

   и

   title

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 марта"}}'

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

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

.

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

insufficient_scope

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

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

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

• Пагинация: cursor-based (limit + cursor), НЕ page-based

Подробнее