Обновлено 12 августа 2026 г.

API для разработчиков solOS v3

Вместо {{YOUR_CRM_URL}} укажите URL-адрес, по которому доступна ваша версия solOS. Для работы с публичными методами передавайте заголовки Solos-User-Token и Solos-User-Secret. В примерах они указаны, как {{YOUR_CRM_TOKEN}} и {{YOUR_CRM_SECRET}} соответственно, вместо реальных ключей. Для сервисных интеграций можно использовать заголовки Solos-App-Token и Solos-App-Secret. Ответы от сервера приходят в формате JSON.

Будьте предельно осторожны при передаче ключей третьим лицам. Ключи имеют такое же значение, как и личные пароли пользователей. Выдавайте ключи только проверенным пользователям, желательно создав для них отдельную группу и тщательно настроив права доступа.

Ключи можно получить в профиле пользователя в разделе Доступ к API.

Сервисные токены можно создать в Настройках в разделе Сервисные токены. Они не привязаны к пользователю, работают только на чтение и подходят для интеграций, которым нужно получать данные без создания, изменения или удаления записей.

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

Коды ответов API сервера

200: Успешно – Запрос был выполнен корректно.
400: Ошибка клиента – Неверный запрос, например, из-за неправильных полей или формата данных.
401: Ошибка авторизации – Проверьте ключ доступа, необходимые заголовки и права пользователя.
403: Доступ запрещён – Пользователь не имеет прав доступа к запрашиваемому ресурсу.
404: Не найдено – Запрос завершился неудачей из-за отсутствия данных на сервере.
500: Ошибка сервера – Если проблема повторяется, пожалуйста, свяжитесь с технической поддержкой f@fbybf.ceb.

При возникновении ошибок обязательно проверяйте срок действия ключей и активность токена.
Доступ по ключам пользователя зависит от его прав доступа. Сервисные токены дают доступ только на чтение.