Модуль 1C-Битрикс
Готовый модуль интеграции API для проектов на 1C-Битрикс.
Описание
Установите модуль, сохраните endpoint и API-ключ, затем используйте helper-методы в бизнес-логике для обогащения запросов GEO/IP-контекстом.
Инструкция
- Скачайте ZIP-пакет.
- Установите модуль в 1C-Битрикс.
- В настройках укажите API URL и API-ключ.
- Используйте компонент и helper API в шаблонах и контроллерах.
Практические рекомендации
- Установите и активируйте пакет в вашей CMS.
- Укажите API endpoint и API-ключ в настройках модуля.
- Проверьте определение IP и корректную передачу User-Agent.
- Вызывайте lookup до авторизации, checkout и risk-решений.
- Добавьте fallback-обработку для timeout/429/5xx ответов API.
Рекомендуемый поток: сначала GEO/IP-контекст, затем бизнес-правила.
Минимальная версия CMS
1C-Bitrix 21.0+
README: детали применения
Bitrix module quick flow:
1) Copy integration/bitrix/portcore.geoip -> <bitrix_root>/bitrix/modules/portcore.geoip
2) Install module in admin: Settings -> Module list
3) Save API Endpoint URL + API Key in module settings
Component:
$APPLICATION->IncludeComponent('portcore:geoip.summary', '.default', ['GEOIP_ARRAY' => $geo]);
Lookup:
\Bitrix\Main\Loader::includeModule('portcore.geoip');
$geo = \Portcore\Geoip\Client::getByIp('2001:bc8:1da0:1e:da5e:d3ff:fe6f:dc87');
Request context:
- validates IPv4/IPv6
- user_id: bxu_{user_id} or bxs_{session_hash}
- user_agent from request (fallback Bitrix-PortcoreGeoip/1.0)