Что такое API и зачем он нужен

API — это «дверь» в CRM для других программ. Через неё ваш сайт, 1С, Telegram-бот или таблица могут сами, без человека, узнавать данные из BSTCRM и добавлять новые. Программисту для этого не нужен доступ к серверу — только ключ, который вы выпустите в настройках.

Что можно сделать через API

• Онлайн-запись с сайта. Клиент оставил заявку на сайте — в CRM сразу появляется клиент и сделка.
• Отчёты в своих таблицах. Выгружать сделки, выручку и долги в Google Таблицы или Power BI по расписанию.
• Связь с 1С или бухгалтерией. Передавать оплаченные сделки, товары и остатки.
• Свой бот или приложение. Показывать клиенту статус ремонта, историю обслуживания его машины.
• Уведомления. С помощью вебхуков CRM сама сообщит вашей программе, что создана сделка, сменился статус или пришла оплата.

Как это устроено

1. Владелец или администратор выпускает ключ API в разделе «Настройки → API и вебхуки». Как выпустить ключ
2. Программист добавляет ключ в каждый запрос: Authorization: Bearer bst_….
3. CRM отвечает данными в формате JSON — так же, как она показывает их на экране.

Что понадобится программисту

• Адрес вашей CRM, например https://ваша-компания.bstcrm.ru.
• Ключ API (его показывают один раз — передайте его безопасным способом, не в общем чате).
• Эта справка: Первый запрос за 5 минут, Основные запросы, Вебхуки, Ошибки и лимиты.