Схема работы
Для примера рассмотрим путь: https://{domain}/api/example/check
Общий принцип работы интерфейса следующий:
При входящем запросе веб-сервер пытается направить запрос по пути /api/example/check.
Когда веб-сервер понимает, что такого пути нет, он инициирует ошибку 404.
Когда срабатывает ошибка 404, то происходит запуск файла 404.php (указывается в настройках веб-сервера).
При запуске файла 404.php, учитывая, что в нем прописаны все директивы Битрикса, начинает отрабатывать файл init.php.
В случае, если файл init.php запускается успешно, то происходит запуск модуля.
При запуске, модуль анализирует настройки, правила и входящий запрос.
В случае, если для входящего запроса прописаны правила в карте роутов, тогда срабатывает контроллер указанный для роута.
В контроллере отрабатывает некоторая логика, которую пропишет разработчик.
В конце отработки метода контроллера необходимо вызвать функцию response()->json() для возврата результата клиенту.
Примечание
Минимальная версия PHP >= 7.2 (согласно требованиям платформы). Использование более ранней версии возможно, но крайне не рекомендуется, в виду возникновения ошибок.
Обязательно наличие файла для обработки 404 ошибки (обычно имеется в корне сайта - 404.php) со всеми "директивами" 1С-Битрикса.
Если используется веб-сервер Apache: обязательно прописать ErrorDocument 404 /404.php в .htaccess, расположенный в корне сайта, или прямо в конфигурационном файле Apache.
Если используется веб-сервер Nginx: обязательно прописать error_page 404 = /404.php?$query_string; в секцию server конфигурационного файла (обычно nginx.conf).
Для работы CORS-запросов необходимо чтобы на веб-сервере были разрешены запросы типа OPTIONS.
Last updated