mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2025-01-28 05:46:35 +02:00
63 lines
3.7 KiB
Markdown
63 lines
3.7 KiB
Markdown
---
|
|
id: Bitrix24
|
|
sidebar_class_name: Bitrix24
|
|
---
|
|
|
|
<img src={require('../../static/img/APIs/Bitrix24.png').default} width='64px' />
|
|
|
|
# Bitrix24
|
|
|
|
Этот раздел посвящен библиотеке для работы с Bitrix24 API. На данной странице описаны все действия, необходимые для полноценного начала работы
|
|
|
|
## Начало работы
|
|
|
|
Работать с Bitrix24 через API можно двумя способами: через **Webhook** и через **локальное приложение**. Для обоих вариантов необходимо:
|
|
|
|
1. Перейти в подраздел **Разработчикам** в разделе **Приложения** боковой панели
|
|
|
|
|
|
|
|
2. Выбрать пункт **Другое**
|
|
|
|
|
|
|
|
<hr/><br/>
|
|
|
|
### Для работы через Webhook
|
|
|
|
1. Выберите пункт **Входящий вебхук**
|
|
|
|
|
|
|
|
2. Заполните необходимые разрешения в **Настройках прав** и сохраните URL вебхука. Он будет использоваться для выполнения методов библиотеки как параметр **URL**. Необязательный параметр **Токен** в данном случае будет всегда оставаться пустым
|
|
|
|
|
|
|
|
<hr/><br/>
|
|
|
|
## Для работы через Локальное приложение
|
|
|
|
1. Выберите пункт **Локальное приложение**
|
|
|
|
|
|
|
|
2. Выберите путь обработчика (если приложение не подразумевает авторизацию других пользователей, но только управление Bitrix через один аккаунт администратора, то можно выбрать любой адрес, например https://localhost), поставьте галочку **Использует только API** (если необходим только функционал вызова методов библиотеки) и заполните необходимые права
|
|
|
|
|
|
|
|
3. Сохраните **ключ** и **код** приложения
|
|
|
|
|
|
|
|
4. При помощи ключа приложения вызовите функцию **ПолучитьСсылкуАвторизацииПриложения** и перейдите по полученной ссылке в браузере. После авторизации, скопируйте полученный код из адресной строки (или получите его на обработчик, адрес которого был указан в пункте 2)
|
|
|
|
|
|
|
|
5. Передайте полученный код, вместе с ключем и секретом приложения, в функцию **ПолучитьТокен**. Сохраните полученные **access** и **refresh токены**
|
|
|
|
6. Время жизни токенов ограничено. Для получение нового токена можно воспользоваться функцией **ОбновитьТокен**, передав тутда refresh токен, ключ и секрет приложения. При обновлении создается не только новый access токен, но и refresh токен тоже
|
|
|
|
|
|
|
|
|