כיצד ליישם CMS ללא ראש על 1C-Bitrix עם REST API ו-JWT

Headless CMS על 1C-Bitrix: Backend מנותק לפרונטאנדים מודרניים

תארו לעצמכם חנות מקוונת על Bitrix עם 50,000 פריטי קטלוג. היא עובדת, אבל הלקוחות דורשים אפליקציה למובייל, ומשווקים צריכים אינטגרציה עם מרקטפלייסים. רכיבים סטנדרטיים מייצרים HTML, חסר תועלת עבור JSON APIs. כל ערוץ חדש דורש שכתוב תבניות, והביצועים יורדים. אנחנו פותרים זאת על ידי יישום ארכיטקטורת headless שבה Bitrix הופך ל-headless CMS טהור, המספק נתונים דרך REST API.https://dev.1c-bitrix.ru/api_d7/bitrix/main/routing/

Headless מפריד בין ה-backend (בלוקי מידע, קטלוג מסחר, CRM) לבין פרונטאנד עצמאי. אתם מקבלים יכולת רב-ערוצית: מקור נתונים אחד לאינטרנט, אפליקציות מובייל, PWAs ועוזרים קוליים—ללא תלות בתבניות Bitrix. זה מפחית עלויות תחזוקה; אנו מעריכים חיסכון בפרונטאנד של 20–30%. אם אתם צריכים להעביר את Bitrix ל-headless, אנו מטפלים במעבר בצורה חלקה.

למה לנתק את Bitrix המונוליטי?

ארכיטקטורת headless מהירה פי 3 מ-Bitrix מונוליטי בעומס שווה. הפרונטאנד העצמאי מאפשר לעדכן את ממשק המשתמש ללא בנייה מחדש של Bitrix. caching רב-שכבתי (Redis + nginx) מהיר פי 10 מאשר ללא caching, ומספק שיפור ביצועים משמעותי.

איך אנחנו בונים headless על 1C-Bitrix

שכבת REST API

ל-Bitrix אין API headless מובנה; אנו מיישמים אותו באמצעות מודול bitrix/routing הרשמי (גרסה 20.0+):https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=3303

// local/routes/api.php
use Bitrix\Main\Routing\RoutingConfigurator;

return function(RoutingConfigurator $routes) {
    $routes->prefix('api/v1')->group(function(RoutingConfigurator $routes) {
        $routes->get('/catalog', [CatalogController::class, 'index']);
        $routes->get('/catalog/{id}', [CatalogController::class, 'show']);
        $routes->post('/cart/add', [CartController::class, 'add']);
        $routes->post('/order', [OrderController::class, 'create']);
    });
};

בקרים מרחיבים את // local/routes/api.php use Bitrix\Main\Routing\RoutingConfigurator; return function(RoutingConfigurator $routes) { $routes->prefix('api/v1')->group(function(RoutingConfigurator $routes) { $routes->get('/catalog', [CatalogController::class, 'index']); $routes->get('/catalog/{id}', [CatalogController::class, 'show']); $routes->post('/cart/add', [CartController::class, 'add']); $routes->post('/order', [OrderController::class, 'create']); }); }; ומחזירים מערכים שמומרים אוטומטית ל-JSON:

// local/controllers/CatalogController.php
class CatalogController extends \Bitrix\Main\Engine\Controller
{
    public function indexAction(int $page = 1, int $limit = 20): array
    {
        $items = \Bitrix\Iblock\Elements\ElementCatalogTable::getList([
            'filter' => ['ACTIVE' => 'Y', 'IBLOCK_ID' => CATALOG_IBLOCK_ID],
            'limit' => $limit,
            'offset' => ($page - 1) * $limit,
        ]);

        return ['items' => $items->fetchAll(), 'page' => $page];
    }
}

עבור חנות מקוונת אחת, בנינו 15 endpoints (סינון, מיון, מחירים עם הנחות, מלאי). זמן התגובה ירד מ-1.2 שניות ל-130 אלפיות השנייה לאחר הפעלת caching.

Caching למהירות

ללא caching, Bitrix headless איטי—כל בקשה לקטלוג מפעילה שאילתות DB. caching רב-שכבתי (Redis + nginx) מספק שיפור ביצועים פי 10:

public function indexAction(): array
{
    $cacheKey = 'catalog_page_' . $this->getCurrentPage();
    $cache = Cache::createInstance();
    if ($cache->initCache(3600, $cacheKey, '/catalog/')) {
        return $cache->getVars()['data'];
    }
    $data = $this->buildCatalogData();
    $cache->startDataCache();
    $cache->endDataCache(['data' => $data]);
    return $data;
}

ה-cache מתבטל על שינויי בלוקי מידע דרך \Bitrix\Main\Engine\Controller ב-// local/controllers/CatalogController.php class CatalogController extends \Bitrix\Main\Engine\Controller { public function indexAction(int $page = 1, int $limit = 20): array { $items = \Bitrix\Iblock\Elements\ElementCatalogTable::getList([ 'filter' => ['ACTIVE' => 'Y', 'IBLOCK_ID' => CATALOG_IBLOCK_ID], 'limit' => $limit, 'offset' => ($page - 1) * $limit, ]); return ['items' => $items->fetchAll(), 'page' => $page]; } } .https://dev.1c-bitrix.ru/api_d7/bitrix/main/data/cache/

CORS ופריסה

אנו מפרידים דומיינים: Authorization (Bitrix) ו-public function indexAction(): array { $cacheKey = 'catalog_page_' . $this->getCurrentPage(); $cache = Cache::createInstance(); if ($cache->initCache(3600, $cacheKey, '/catalog/')) { return $cache->getVars()['data']; } $data = $this->buildCatalogData(); $cache->startDataCache(); $cache->endDataCache(['data' => $data]); return $data; } (פרונטאנד). הגדרת CORS ב-nginx:

location /api/ {
    add_header 'Access-Control-Allow-Origin' 'https://yoursite.ru';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
    add_header 'Access-Control-Allow-Headers' 'Authorization, Content-Type';
    add_header 'Access-Control-Allow-Credentials' 'true';
    if ($request_method = 'OPTIONS') {
        return 204;
    }
    fastcgi_pass php-fpm;
}

אנו יכולים גם ליישם API Gateway עבור Bitrix כדי לאגד שירותים מרובים.

מלכודות נפוצות ופתרונות

תהליך ולוחות זמנים

1. ביקורת אתר: בלוקי מידע, אינטגרציות, עומס – 1–2 ימים.
2. עיצוב API: מפרטי endpoints, סכמות נתונים – 2–3 ימים.
3. פיתוח API ו-caching: בקרים, middleware, בדיקות – 1–3 שבועות.
4. תשתית: CORS, nginx, Redis, פריסה – 2–3 ימים.
5. אינטגרציית פרונטאנד: בדיקות משותפות – שבוע אחד.

פרויקט טיפוסי: 2–6 שבועות. העלות מחושבת באופן אישי לאחר ביקורת (החל מ-$5,000). עלות פרויקט ממוצעת היא $8,000–$15,000.

מה כלול

• תיעוד API מלא (OpenAPI/Swagger).
• קוד מקור: בקרים, middleware, תצורות.
• הגדרת caching ו-CORS על השרת שלכם.
• הוראות פריסה ועדכון.
• הדרכת מפתחים (שעתיים אונליין).
• תמיכה למשך שבועיים לאחר ההשקה.

יתרונות מרכזיים

לצוות שלנו יש מעל 10 שנות ניסיון עם Bitrix ו-5 שנים ב-headless. יישמנו backend מנותק ל-50+ פרויקטים, כולל קטלוגים עם 200,000 פריטים ועומסים של 10,000 בקשות/דקה. החיסכון בתחזוקה ובפיתוח ערוצים חדשים מגיע ל-40% (בממוצע $2,000 לחודש). אנו מבטיחים API יציב ותיעוד מלא.

בקשו ביקורת על הפרויקט שלכם—נעריך לוחות זמנים ועלות ביום אחד. צרו קשר לייעוץ.