Перейти к основному содержимому

Bitrix24

Этот раздел посвящен библиотеке для работы с Bitrix24 API. На данной странице описаны все действия, необходимые для полноценного начала работы

Начало работы​

Работать с Bitrix24 через API можно двумя способами: через Webhook и через локальное приложение. Для обоих вариантов необходимо:

  1. Перейти в подраздел Разработчикам в разделе Приложения боковой панели

BF

  1. Выбрать пункт Другое

BF


Для работы через Webhook​

  1. Выберите пункт Входящий вебхук

BF

  1. Заполните необходимые разрешения в Настройках прав и сохраните URL вебхука. Он будет использоваться для выполнения методов библиотеки как параметр URL. Необязательный параметр Токен в данном случае будет всегда оставаться пустым

BF


Для работы через Локальное приложение​

  1. Выберите пункт Локальное приложение

BF

  1. Выберите путь обработчика (если приложение не подразумевает авторизацию других пользователей, но только управление Bitrix через один аккаунт администратора, то можно выбрать любой адрес, например https://localhost), поставьте галочку Использует только API (если необходим только функционал вызова методов библиотеки) и заполните необходимые права

BF

  1. Сохраните ключ и код приложения

BF

  1. При помощи ключа приложения вызовите функцию ПолучитьСсылкуАвторизацииПриложения и перейдите по полученной ссылке в браузере. После авторизации, скопируйте полученный код из адресной строки (или получите его на обработчик, адрес которого был указан в пункте 2)

BF

  1. Передайте полученный код, вместе с ключем и секретом приложения, в функцию ПолучитьТокен. Сохраните полученные access и refresh токены

  2. Время жизни токенов ограничено. Для получение нового токена можно воспользоваться функцией ОбновитьТокен, передав тутда refresh токен, ключ и секрет приложения. При обновлении создается не только новый access токен, но и refresh токен тоже