Bitrix24 REST API: yadroni o‘zgartirmasdan qo‘shimchalar va integratsiyalar

Bitrix24 sozlamalari, robotlari va biznes-jarayonlari ko‘p vazifani hal qiladi. Lekin tashqi tizim bilan ma’lumot almashish, o‘ziga xos hisob-kitob yoki yangi interfeys kerak bo‘lganda REST API ishlatiladi. Bu bulutli Bitrix24’ni o‘zgartirishning asosiy rasmiy yo‘li, chunki bulutda platforma kodiga kirish yo‘q.

REST API nima

Bu tashqi dasturlar Bitrix24 bilan internet orqali ma’lumot almashadigan interfeys. Dastur so‘rov yuboradi — masalan, «yangi lid yarat» yoki «bitimlar ro‘yxatini ber» — va javob oladi. Metodlar CRM, vazifalar, foydalanuvchilar, disk, kalendar, chat, telefoniya va boshqa modullarni qamrab oladi. Rasmiy hujjatlarda har bir metod tavsiflangan.

Ulanish usullari

Kiruvchi vebhuk. Portalda maxsus manzil yaratiladi, tashqi skript u orqali so‘rov yuboradi. Oddiy integratsiyalar uchun eng tez yo‘l: masalan, sayt formasidan lid yaratish.

Chiquvchi vebhuk. Portalda hodisa sodir bo‘lganda — bitim yaratildi, bosqich o‘zgardi — Bitrix24 sizning serveringizga xabar yuboradi.

Lokal ilova. Faqat sizning portalingizda ishlaydigan ilova. U Bitrix24 interfeysiga joylashishi — bitim kartochkasida yangi tab, menyuda yangi bo‘lim — va OAuth orqali avtorizatsiya qilinishi mumkin.

Ommaviy ilova. Bitrix24 bozorida e’lon qilinadigan va boshqa portallar o‘rnatadigan ilova.

Tipik vazifalar

1. 1C, ERP yoki ombor tizimi bilan almashinuv
2. Sayt, mobil ilova yoki shaxsiy kabinetdan arizalar va buyurtmalar
3. Telegram bot va CRM o‘rtasida ma’lumotlar
4. Murakkab taqsimlash yoki hisob-kitob qoidalari
5. Bitim kartochkasida tashqi ma’lumotlarni ko‘rsatish
6. BI tizimi uchun ma’lumotlarni yuklab olish
7. Robotlar uchun o‘z amallarini qo‘shish

O‘z robotlaringiz

REST API orqali yangi robot va biznes-jarayon amallarini ro‘yxatdan o‘tkazish mumkin. Ular administratorga konstruktorda oddiy robot sifatida ko‘rinadi, lekin bajarilishi sizning serveringizda. Bu dasturchi bir marta yozgan mantiqni administratorlar istalgan voronkada qayta ishlatishi imkonini beradi.

Cheklovlar

• So‘rovlar soni vaqt birligida cheklangan; ommaviy operatsiyalar paketlarga bo‘linadi
• Har bir metod va maydon ham API orqali mavjud emas
• Bulut versiyasida platformaning ichki xatti-harakatini o‘zgartirib bo‘lmaydi

Aniq cheklovlarni joriy hujjatlardan tekshiring.

Xavfsizlik

• Vebhuk manzili va kalitlar parol kabi maxfiy
• Integratsiyaga faqat kerakli modullarga ruxsat bering
• Loyiha tugagach, keraksiz vebhuklar va ilovalarni o‘chiring
• Integratsiya harakatlarini jurnalga yozing

Vebhuk manzilini kodda ochiq qoldirish — butun CRM’ga kirishni berish demak.

Vazifani qanday qo‘yish

Biznes tilida yozing: hodisa, harakat, ma’lumotlar, xato holati. Masalan: «Bitim „To‘landi“ bosqichiga o‘tganda ombor tizimida yig‘ish topshirig‘i yaratilsin; topshiriq raqami bitimga yozilsin; ombor tizimi javob bermasa, administratorga xabar ketsin».

Qo‘llab-quvvatlash

API integratsiyasi yashaydigan tizim. Kod qayerda saqlanadi, kim mas’ul, server qayerda ishlaydi, xatolar qanday kuzatiladi — bularni hujjatlashtiring. Hujjatsiz integratsiya dasturchi almashganda eng katta muammoga aylanadi.