שער API של Bitrix24: מטמון, אצווה, ניהול טוקנים

שער API של Bitrix24: מטמון, עיבוד קבוצתי, ניהול טוקנים

לעתים קרובות אנו רואים את אותה בעיה: אפליקציה ניידת, אתר חיצוני ומערכת ERP עובדים בו-זמנית עם REST API של Bitrix24. כל לקוח מאחסן טוקנים משלו, כל אחד חייב להכיר את פרטי השיטות ולעקוף מגבלות. זה לא נוח, לא מאובטח ומאט את הפיתוח. שער API הוא שכבת ביניים שאנו מתכננים עבור הפרויקט שלך. הוא מתקן את האינטראקציה: יישומי לקוח קוראים לשער עם ממשק פשוט, והשער מתרגם קריאות ל-Bitrix24, מאגד נתונים ומחזיר תשובה מנורמלת. הערך את הפרויקט שלך ביום אחד — פשוט צור איתנו קשר.

למה אתה צריך שער API עבור Bitrix24?

הסתרת מורכבות ה-API של Bitrix24. שליפת עסקה עם כל הנתונים הקשורים (איש קשר, חברה, מוצרים, משימות, פעילויות) דורשת 5–7 קריאות REST נפרדות לשיטות שונות. השער מבצע קריאה אחת /deals/123, אוסף את כל הנתונים במקביל ומחזיר JSON יחיד ללקוח.

ניהול טוקנים. יישומי לקוח אינם מאחסנים טוקנים של Bitrix24. השער הוא המקום היחיד שבו מאוחסנים טוקני OAuth, access_token מתחדש דרך refresh_token, והסיבוב נשלט.

עקיפת מגבלות. Bitrix24 בענן מגביל: 2 בקשות בשנייה, 50 פעולות בקבוצה. השער מיישם תור ומגביל קצב — לקוחות שולחים בקשות במהירות שהם רוצים, והשער מחליק את העומס. אינטגרציה ישירה דורשת חישוב מגבלות בצד הלקוח; השער לוקח על עצמו את זה.

למה שער API מפחית עלויות פיתוח?

במקום שכל צוות לקוח ילמד את נבכי ה-REST API של Bitrix24, השער מספק ממשק יחיד ומתועד. מפתחים משקיעים פחות זמן באינטגרציה ויותר בלוגיקה עסקית. בפועל, זה מפחית את זמן ההגעה לשוק עבור תכונות חדשות ב-30%.

ארכיטקטורת השער ואימות

השער הוא שירות HTTP נפרד, בדרך כלל PHP (Laravel/Slim) או Node.js. הוא יושב בין לקוחות ל-Bitrix24.

Клиенты (мобильное приложение, внешний сайт, ERP)
    ↓ HTTP/JSON (собственный API шлюза)
API-шлюз
├── Аутентификация клиента (JWT / API Key)
├── Валидация входных данных
├── Rate limiter
├── Кеш (Redis)
├── Маппер запросов → Bitrix24 REST
└── Batch-агрегатор
    ↓ OAuth2 Token
Bitrix24 REST API

אימות באמצעות מפתח API

הפשוט ביותר עבור שרת-לשרת. הלקוח שולח את המפתח בכותרת Клиенты (мобильное приложение, внешний сайт, ERP) ↓ HTTP/JSON (собственный API шлюза) API-шлюз ├── Аутентификация клиента (JWT / API Key) ├── Валидация входных данных ├── Rate limiter ├── Кеш (Redis) ├── Маппер запросов → Bitrix24 REST └── Batch-агрегатор ↓ OAuth2 Token Bitrix24 REST API . השער מאמת את המפתח במסד הנתונים שלו, מזהה את חשבון Bitrix24 המקושר ואת ההרשאות.

אימות באמצעות JWT

עבור לקוחות עם משתמשים. המשתמש מתחבר (דרך OAuth של Bitrix24 או מערכת מותאמת), השער מנפיק טוקן JWT. כל בקשה לשער נושאת את ה-JWT בכותרת X-API-Key. השער מפענח את הטוקן, מזהה את המשתמש ופועל בשמו ב-Bitrix24.

אימות באמצעות OAuth 2.0

אם השער משרת מספר יישומי לקוח מארגונים שונים, בנה שרת OAuth מלא (זרימת קוד הרשאה). כל יישום לקוח הוא לקוח OAuth נפרד של השער.

איך מטמון ועיבוד קבוצתי מאיצים ביצועים

שתי רמות מטמון:

מפתח מטמון: Authorization: Bearer. באירוע webhook b24:{portal_id}:{method}:{hash(params)} עם ONCRMDEALUPDATE — פסול ID=123. בזכות המטמון, זמן התגובה יורד פי 5 בהשוואה לבקשות ישירות.

Bitrix24 תומך בעיבוד קבוצתי: עד 50 שיטות בבקשת HTTP אחת. השער מאגד קריאות לקוח מקבילות לקבוצה. לפי תיעוד ה-REST API הרשמי של Bitrix24, זה מפחית באופן דרמטי חיבורי HTTP. דוגמה לבקשת קבוצה:

// Клиент вызывает 3 ресурса шлюза "одновременно"
// Шлюз собирает их в один batch к Bitrix24:
$batch = [
    'deal' => 'crm.deal.get?id=123',
    'contact' => 'crm.contact.get?id=456',
    'products' => 'crm.deal.productrows.get?id=123',
];
$result = $b24->batch($batch);

{
  "id": 123,
  "title": "Сделка с компанией Рога и Копыта",
  "amount": 50000.00,
  "stage": "negotiation",
  "contact": {
    "id": 456,
    "name": "Иван Петров",
    "phone": "+79001234567"
  }
}