COMMON — заметки практики

Что здесь: проверенные практикой правила и грабли сервиса COMMON (контакты, справочники, вложения). Сигнатуры ручек — endpoints/COMMON.md. Когда сюда идти: перед работой с контактами и справочниками через API.

Грабли

⚠ HEAD /Contacts → 404: у контактов, в отличие от заявок (HEAD /Tasks), HEAD не реализован (проверено 2026-07-15; в swagger у /Contacts объявлены только GET/POST/PUT/DELETE). Узнать тотал без вычитки страницы нечем — брать его из Content-Range обычного GET /Contacts с заголовком Range.

⚠ GET /Contacts ?searchText ищет одновременно по ФИО, телефону и email, включая частичное совпадение (проверено 2026-07-15: +77653434343 → 1 запись; kolotyh → 1 запись по kolotyh@gmail.com; Иван → 6 записей по ФИО). Поле position поиск не охватывает: тестер → 0 записей при существующем контакте с position: "тестер". Отдельных параметров поиска по телефону/почте у ручки нет — они и не нужны.

⚠ GET /Contacts не поддерживает сортировку (orderBy в параметрах нет, в отличие от GET /Tasks) — порядок выдачи по id по возрастанию (проверено 2026-07-15: id 10, 21, 27, 40, 51, 52, 105, 106). Сортировать выдачу на клиенте постранично нельзя: отсортируется только текущая страница, а выглядеть будет как сортировка всего списка.

Наиболее используемые

GET /Contacts, GET /Contacts/{contactID} — расшифровка в overview.md.