Публичный API 2base.ru помогает получить доступные сведения о компании, но не выдаёт открытые телефоны и email. Для загрузки приобретённых контактов используйте полученный файл и согласованный процесс импорта. Готовый коннектор не подразумевается: ниже схема собственной интеграции.
Определите поля и правила
Сохраните ИНН как строку. Отдельно сопоставьте название, ОГРН, адрес, ОКВЭД и статус с полями CRM. Не переносите маску телефона или email в рабочее контактное поле. Пустой ответ внешнего источника не должен удалять заполненное значение в CRM.
Доступ к CRM
Выберите разрешённый для вашего портала способ доступа: локальный вебхук или приложение. Набор прав должен покрывать только используемые сущности; секрет вебхука храните на сервере. Настройте журнал изменений: карточка, поле, прежнее и новое значения, источник и результат операции.
Получение сведений
- Проверьте ИНН и выполните поиск через публичный endpoint
/api/v1/search?q=ИНН. - Сравните ИНН найденной записи с исходным. Совпадение названия или первый результат поиска не являются достаточным основанием.
- Используйте slug выбранной компании для
/api/v1/companies/:slug. Состав полей смотрите в OpenAPI. - Запишите только разрешённые поля. При нескольких совпадениях или конфликте отправьте карточку на ручную проверку.
Надёжность
Публичные методы работают без API-ключа; лимит группы API — 30 запросов в минуту на IP. Поставьте запросы в очередь, обрабатывайте 429 с задержкой, ограничьте повторы и кэшируйте повторный поиск. Это не API для обхода ограничений массовой выгрузки.
Проверка до включения
Протестируйте известную компанию, отсутствующий ИНН, неоднозначный ответ, пустые поля, маски контактов и повторную доставку события. Повтор не должен создавать дубликат или повторно затирать ручную правку. Начните с отдельной тестовой группы карточек.