REST API Bitrix24: настройка и использование внешних приложений и интеграций
Rest API (Representational State Transfer Application Programming Interface) в Bitrix24 - это набор методов и инструментов, которые позволяют разработчикам взаимодействовать с системой Bitrix24 через HTTP протокол.
С помощью Rest API Bitrix24 разработчики могут создавать, изменять и удалять объекты в системе Bitrix24, такие как сделки, контакты, задачи, компании и другие элементы. Также API позволяет получать информацию о существующих объектах, выполнять поиск и фильтрацию данных.
Вот примеры использования Rest API Bitrix24:
1. Создание новой сделки:
javascript
const axios = require('axios');
const createDeal = async (accessToken, dealData) => {
try {
const response = await axios.post(
'https://your-domain.bitrix24.com/rest/crm.deal.add.json',
{
fields: dealData,
auth: accessToken,
}
);
console.log('Создана новая сделка:', response.data.result);
} catch (error) {
console.error('Ошибка при создании сделки:', error);
}
};
const accessToken = 'YOUR_ACCESS_TOKEN';
const dealData = {
TITLE: 'Новая сделка',
COMPANY_ID: 123,
CONTACT_ID: 456,
};
createDeal(accessToken, dealData);
2. Получение информации о существующей задаче:
javascript
const axios = require('axios');
const getTask = async (accessToken, taskId) => {
try {
const response = await axios.get(
`https://your-domain.bitrix24.com/rest/task.item.get.json?id=${taskId}&auth=${accessToken}`
);
console.log('Информация о задаче:', response.data.result);
} catch (error) {
console.error('Ошибка при получении информации о задаче:', error);
}
};
const accessToken = 'YOUR_ACCESS_TOKEN';
const taskId = 789;
getTask(accessToken, taskId);
3. Обновление контакта:
javascript
const axios = require('axios');
const updateContact = async (accessToken, contactId, contactData) => {
try {
const response = await axios.post(
'https://your-domain.bitrix24.com/rest/crm.contact.update.json',
{
id: contactId,
fields: contactData,
auth: accessToken,
}
);
console.log('Контакт успешно обновлен:', response.data.result);
} catch (error) {
console.error('Ошибка при обновлении контакта:', error);
}
};
const accessToken = 'YOUR_ACCESS_TOKEN';
const contactId = 123;
const contactData = {
NAME: 'Иван',
LAST_NAME: 'Иванов',
PHONE: [
{
VALUE: '+7 (123) 456-7890',
VALUE_TYPE: 'WORK',
},
],
};
updateContact(accessToken, contactId, contactData);
Это лишь несколько примеров использования Rest API Bitrix24. С помощью API можно взаимодействовать с различными объектами и выполнять разнообразные операции в системе Bitrix24, от чего зависит функциональность вашего приложения или интеграции.