YCLIENTS API: что можно и чего нельзя сделать

YCLIENTS предоставляет REST API для работы с данными CRM. Но не все функции CRM доступны через API, и не все работают так, как ожидаешь. Разберем по пунктам.

Что работает хорошо

• Записи - создание, редактирование, удаление, получение списка. Полный CRUD.
• Клиенты - поиск, создание, обновление карточек. Фильтрация по телефону, имени.
• Расписание - свободные слоты, загрузка мастеров, доступные даты.
• Услуги и категории - полный список с ценами, длительностью.
• Абонементы - баланс, списание через Payment API.
• Webhook-и - уведомления о событиях в реальном времени.

Что работает с ограничениями

• Сертификаты - можно создать и удалить, но нельзя изменить баланс существующего. Обходной путь: удалить старый, создать новый.
• Финансы - частичный доступ. Кассовые операции через API ограничены.
• Склад - базовые операции есть, но сложная логика (серии, партии) не поддерживается.
• Зарплаты - расчет зарплат через API недоступен.

Что не работает

• Изменение настроек филиала
• Управление виджетом записи
• Доступ к статистике и отчетам (нет API)
• Управление SMS-рассылками

Лимиты

200 запросов в минуту, 5 запросов в секунду с одного IP. Для большинства задач этого хватает. Для массовых операций (миграция данных, синхронизация) нужно учитывать задержки.

Авторизация

Два токена: Partner Token (получаете в кабинете разработчика) и User Token (авторизация конкретного пользователя). Для webhook-обработки достаточно Partner Token.

Если ваша задача попадает в "работает хорошо" - реализация будет быстрой и надежной. Если в "ограничения" - тоже решаемо, но нужно искать обходные пути.