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

Bitrix24

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

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

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

Работа через Webhook

  1. Перейти в подраздел Разработчикам в разделе Приложения боковой панели
  2. Выбрать пункт Другое
  3. Выберите пункт Входящий вебхук
  4. Заполните необходимые разрешения в Настройках прав и сохраните URL вебхука. Он будет использоваться для выполнения методов библиотеки как параметр URL. Необязательный параметр Токен в данном случае будет всегда оставаться пустым

Работа через локальное приложение

  1. Перейти в подраздел Разработчикам в разделе Приложения боковой панели Bitrix24
  2. Выбрать пункт Другое
  3. Выберите пункт Локальное приложение
  4. Выберите URL обработчика. Если приложение не подразумевает авторизацию других пользователей, а только управление Bitrix через один аккаунт администратора, то можно выбрать любой адрес, например https://localhost.
  5. Поставьте галочку Использует только API (если необходим только функционал вызова методов библиотеки) и заполните необходимые права
  6. Сохраните ключ и код приложения
  7. Передайте ключ приложения в функцию ПолучитьСсылкуАвторизацииПриложения и перейдите по полученной ссылке в браузере
  8. Авторизуйтесь и скопируйте полученный код из адресной строки или получите его на обработчик, адрес которого был указан в пункте 4
  9. Передайте полученный код, вместе с ключом и секретом приложения, в функцию ПолучитьТокен
  10. Сохраните полученные access и refresh токены
important

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