Core employees

Получить сотрудников кабинета

Страница карточек: сначала активные, затем по ФИО. Ответ называет применённые limit и offset; страница ровно в limit строк означает, что дальше может быть ещё, — запрашивайте следующую с offset += limit. Реквизиты (inn, bank_bic, bank_account, phone, email, notes) чужих карточек без права core.employee_requisites:read приходят пустыми строками; своя карточка — целиком.

get/api/v1/core/employees

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/core/employees
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)
    • HTTP bearer

Query parameters

qstring

Поиск по ФИО, должности, отделу и локации; по телефону и почте — только с правом core.employee_requisites:read

limitinteger

Размер страницы. Двести — и умолчание, и потолок: столько отдаёт читающая функция; запрос сверх потолка зажимается до него, а не отклоняется, и применённое значение возвращается в ответе

offsetinteger

Сколько карточек пропустить; отрицательное значение читается как начало списка

affiliation'own' | 'external' | 'guest'

Отбор по принадлежности: own — свои, external — внешние участники, guest — гости-подрядчики; без параметра — все. Другое значение — 400 core.employee.affiliation_invalid

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Response

Карточки сотрудников

countinteger required
limitinteger required

Применённый размер страницы — после зажима до потолка

offsetinteger required

Применённое смещение

Changes

No recorded changes to this operation across all 1 revision of this API.