#Partner Connect

Интегрируйте своё приложение с Битрикс24 через Vibe Platform. Partner Connect позволяет внешним сервисам получать API-ключи для порталов пользователей через стандартный OAuth-подобный flow.

#Обзор

Partner Connect API реализует Authorization Code flow: ваше приложение перенаправляет пользователя на страницу согласия Vibe Platform, пользователь выбирает портал и подтверждает запрошенные скоупы, затем вы обмениваете полученный код на долгоживущий API-ключ.

Сценарий использования: Вы разрабатываете SaaS-платформу (CRM-аналитика, интеграция с 1С, чат-бот) и хотите подключать порталы Битрикс24 ваших клиентов через кнопку «Подключить Битрикс24».

#Как это работает

Ваше приложение → [1. Redirect] → Vibe Consent Page → [2. User approves]
    ↑                                                          ↓
    └──── [4. API Key] ←── [3. Code → redirect_uri] ──────────┘
  1. Redirect — вы отправляете пользователя на /v1/connect/authorize с вашими credentials и скоупами
  2. Согласие — пользователь видит страницу согласия, выбирает портал Битрикс24 и подтверждает доступ
  3. Код — после одобрения пользователь перенаправляется на ваш redirect_uri с параметрами code и state
  4. Обмен — ваш сервер отправляет POST /v1/connect/token с кодом и получает API-ключ

#Шаг 1: Перенаправление на авторизацию

#GET /v1/connect/authorize

Перенаправляет пользователя на страницу согласия.

Query-параметры:

Параметр Обязательный Описание
client_id да Ваш идентификатор партнёра
redirect_uri да URL обратного вызова (должен быть зарегистрирован)
state да Случайная строка для защиты от CSRF
scopes нет Запрашиваемые скоупы через запятую (по умолчанию — скоупы из настроек партнёра)

Пример URL:

https://vibecode.bitrix24.tech/v1/connect/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=https://yourapp.com/callback&scopes=crm,task&state=abc123random

После одобрения пользователь перенаправляется на:

https://yourapp.com/callback?code=AUTH_CODE_HERE&state=abc123random

#Шаг 2: Обмен кода на API-ключ