Благодаря REST-библиотеке Битрикс24 у интеграторов, внедряющих этот продукт, появилось огромное поле для расширения базового функционала корпоративного портала.
Мы можем писать интеграции портала с любыми системами, добавлять свои отчеты, реализовывать процессные сценарии, отталкиваясь от кастомных событий на портале.
Перед разработчиками встает вопрос: как правильно работать с REST-библиотекой с учетом того, что многие действия в ней носят повторяющийся между многими приложениями характер. К ним относятся получение токена авторизации или его обновление, отправка базового REST-запроса и т.д..
Вместо того, чтобы изобретать велосипед и опутывать ваше приложение массой самописных CURL-функций, рекомендую рассмотреть вариант применения Software Development Kit.
Из проверенных есть два варианта:
- простая библиотека CRest https://github.com/bitrix-tools/crest за авторством вендора;
- более сложная библиотека Mesilov SDK https://github.com/mesilov/bitrix24-php-sdk Максима Месилова.
Первую библиотеку можно подключить просто командой include файла, вторую, — надо подключать исключительно через composer.
Обе библиотеки предполагают работу с объектом, функции которого выполняют REST-команды. При этом, в случае c CRest токены авторизации извлекаются из *.json файла, а второй библиотеки, — добавляются в качестве свойств данного объекта.
Mesilov SDK обладает другими превосходствами, в частности, имеет встроенный механизм работы с исключениями (Exception), базируется на более надежных Symfony — библиотеках работы через HTTP, применяет инструмент логирования (Monolog).
Если перед Вами встает задача разработки приложений для маркетплейс, где соответствующие токены необходимо извлекать из базы данных, обеспечивать надежность доставки сообщений и контроль возникающих ошибок, то библиотека Месилова является единственно верным вариантом.