Алгоритм создания сделки через REST в Bitrix24 следующий:
- Аутентификация:
- Получить информацию о приложении (clientid и clientsecret) в разделе "Веб-приложения" на портале Bitrix24.
- После получения clientid и clientsecret, необходимо выполнить запрос на получение accesstoken и refreshtoken с помощью метода авторизации OAuth 2.0 (https://oauth.bitrix.info/oauth/token/).
- Создание сделки:
- Сформировать POST-запрос на создание сделки с использованием endpoint
/crm.deal.add(https://yourdomain.bitrix24.ru/rest/1/yourclient_id/crm.deal.add). - Указать необходимые параметры сделки в теле запроса, такие как название, ответственный пользователь, стадия сделки и т.д.
Пример запроса:
POST /rest/1/your_client_id/crm.deal.add
Content-Type: application/json
Authorization: Bearer your_access_token
{
"fields": {
"TITLE": "Новая сделка",
"ASSIGNED_BY_ID": 1,
"STAGE_ID": "NEW"
// Добавьте здесь другие необходимые поля
}
}
Пример успешного ответа:
{
"result": 1,
"result_message": "Добавлена новая сделка с ID 123"
}
- Обработка ошибок:
- В случае ошибки при создании сделки, API вернет соответствующий код ошибки и сообщение с ошибкой.
- Необходимо обрабатывать возможные ошибки и возвращать соответствующую информацию пользователю (например, путем вывода сообщения об ошибке на экран или записи в журнал ошибок).
Важно отметить, что перед использованием REST API Bitrix24 необходимо иметь доступ к соответствующему разделу (например, CRM) и права на выполнение операции создания сделки.