Апитет — продвинутый визуальный конструктор HTTP/REST-интеграций для 1С без единой строчки кода

Ограничения версии 1.0

Загрузка данных поддерживается в реквизиты шапки справочников и документов, а также в регистры сведений. Загрузка в табличные части появится в следующих версиях.

Собственная форма расписания в Апитете рассчитана на быстрые базовые сценарии: ежедневно или с интервалом в течение дня. Для более сложных схем расписания — по конкретным дням недели или ежемесячно — используйте штатный интерфейс платформы «Регламентные и фоновые задания».

Остались вопросы?

Для получения дополнительной информации и помощи в настройке модуля под задачи вашего бизнеса оставьте заявку.

Подробнее

Причины купить

• Сокращает время настройки интеграции с недель до минут — без единой строчки кода
• Работает внутри вашей базы 1С — не нужна отдельная инфраструктура или тяжёлая ESB-платформа
• Не требует захода в конфигуратор — никаких "битых кэшей" и недовольства коллег из-за перезагрузки базы
• Справится не только программист — аналитик или руководитель проекта настроит интеграцию сам, если нужные объекты метаданных в базе уже есть
• Не зависит от метаданных самой конфигурации — подходит для любой базы 1С (с учётом платформенных требований), не привязан к конкретному решению
• Автоматическая загрузка по расписанию — регламентное задание настраивается в пару кликов, без обращения к разработчику
• Встроенная защита данных — секреты (токены, ключи API) шифруются автоматически, права пользователя проверяются перед каждой записью
• Гибкая работа с любыми API — JSON и XML, постраничные ответы, вложенные запросы, трансформация полей при загрузке
• Экономия на разработке — не нужно каждый раз нанимать программиста писать интеграцию с нуля под новый сервис

Достоинства

Что решает Апитет

Любой бизнес рано или поздно сталкивается с задачей "получить данные из внешнего сервиса в 1С" или "отправить данные из 1С куда-то наружу" — курсы валют, статусы доставки, данные CRM, платёжные системы, любой сторонний API. Классический путь — либо нанимать программиста писать интеграцию с нуля на встроенном языке (HTTPСоединение, ручной парсинг JSON/XML, регламентные задания вручную) — это дни, а часто и недели работы, либо покупать тяжёлую ESB-платформу с отдельной инфраструктурой ради простой задачи.

Апитет сокращает это время в разы. Настройка типового запроса — от вставки адреса API до первого успешного ответа — занимает минуты, а не дни. Вся сложность (сборка URL, заголовков, тела запроса, разбор ответа, обработка ошибок) уже реализована внутри расширения — от пользователя требуется только визуально указать, что откуда брать и куда класть.

Не обязательно быть программистом. Если в базе уже есть нужные справочники/документы/регистры сведений (обычная ситуация для любой работающей учётной системы) — настроить саму интеграцию через понятный визуальный интерфейс вполне по силам аналитику, руководителю проекта или любому продвинутому пользователю 1С, знакомому с устройством своей базы. Программист нужен для того, чтобы один раз создать недостающие объекты метаданных под конкретную задачу — а саму настройку запроса, маппинга полей и расписания загрузки можно доверить не-разработчику.

Ключевые возможности

• Визуальная настройка запросов — укажите адрес API, метод (GET/POST/PUT/DELETE/PATCH/HEAD/OPTIONS), заголовки, параметры — без написания кода. Base URL и путь запроса определяются автоматически при вставке полного адреса. Заголовки можно вставлять "пачкой" — скопируйте их прямо из документации API и вставьте одним действием, после чего останется только заполнить нужные значения в табличной части. Предусмотрена автоматическая защита от дублирования заголовков при повторной вставке.
• Поддержка JSON и XML — оба формата ответа обрабатываются "из коробки", включая автоматическое построение схемы структуры ответа для удобства настройки маппинга.
• Гибкий маппинг полей — сопоставление полей API с реквизитами объектов 1С (справочники, документы, регистры сведений), с правилами трансформации: изменение регистра, обрезка, префиксы/суффиксы, поиск по подстроке, замена текста, а также поиск ссылок на справочники/перечисления по наименованию или коду. Перед каждой загрузкой Апитет автоматически проверяет совместимость типов данных API с типами целевых реквизитов 1С, а также права текущего пользователя на запись в целевой объект — при обнаружении несовместимости загрузка отклоняется с понятным описанием причины, а не портит данные молча.
• Автоматическая загрузка по расписанию — регламентные задания настраиваются в пару кликов прямо из карточки Endpoint'а.
• Постраничный обход (серии запросов) — для API, отдающих данные страницами, Апитет сам пройдёт все страницы и соберёт результат.
• Вложенные запросы — значение из ответа одного Endpoint'а можно использовать как параметр для другого (например, сначала получить токен авторизации, затем использовать его в следующем запросе), с автоматическим TTL-кешированием результата. Глубина вложенности ограничена одним уровнем (запрос не может, в свою очередь, зависеть от другого вложенного запроса), при этом количество параллельных независимых вложенных запросов не ограничено.
• Автоматическое шифрование секретов — токены, ключи API и пароли, обнаруженные по названию поля, автоматически шифруются при сохранении.
• Ограничение частоты запросов (rate limiting) и поддержка прокси — настраиваются на уровне домена (группы Endpoint'ов).
• Переменные окружения — удобное переключение между тестовым и боевым контуром внешнего сервиса без переписывания настроек.
• Настройка формата даты и часового пояса под конкретный API — если внешний сервис ожидает даты в нестандартном формате или в другом часовом поясе, это настраивается выбором из справочника прямо в карточке Endpoint'а, без единой строчки кода — Апитет сам преобразует и отформатирует дату перед отправкой.
• Конструктор тела запроса — визуальное дерево для сборки JSON-тела запроса любой вложенности, с подстановкой масок ([ТекущаяДата], [GUID], номер страницы и др.).
• Поиск API сервиса (Discovery) — попробует автоматически обнаружить swagger/openapi-описание по указанному адресу.
• Защита от параллельного запуска — если регламентная загрузка ещё выполняется, а подходит время следующего запуска (или кто-то запускает ту же самую загрузку вручную в этот момент) — Апитет корректно распознаёт это и не позволяет двум экземплярам одной и той же загрузки выполняться одновременно, исключая риск дублирования или порчи данных из-за наложения процессов.
• Журналирование всех запросов — полная история выполненных запросов с кодами ответов, для контроля и отладки.

Никакого конфигуратора. Никаких перезаходов. Никаких обид коллег.

Любое действие в Апитете — создание Endpoint'а, настройка маппинга, запуск загрузки, изменение расписания — выполняется в обычном режиме 1С:Предприятие, через привычные формы. Не нужно заходить в конфигуратор, обновлять конфигурацию базы данных, просить всех коллег перезайти в программу.

Это полностью снимает классическую боль любой доработки на встроенном языке — "битый кэш" после динамического обновления конфигурации, зависшие сеансы, недовольство бухгалтерии и других отделов, которых регулярно просят "выйти на пять минут, идёт обновление". С Апитетом такой проблемы просто не существует: настроили интеграцию — она сразу работает, без необходимости трогать саму базу на техническом уровне.

Для кого:

1С-разработчиков — как готовый, не требующий разработки с нуля инструмент под любую задачу интеграции. Для аналитиков, руководителей проектов и продвинутых пользователей 1С — как способ настроить интеграцию самостоятельно, без ожидания в очереди к программисту, если нужные объекты метаданных в базе уже есть.

Технические требования

1С:Предприятие 8.3.10 и выше. Расширение подключается к любой конфигурации на управляемых формах.

Лицензирование

Расширение требует активации лицензионным файлом, привязанным к конкретной установке (идентификатору информационной базы). Идентификатор установки отображается прямо в форме активации после установки — отправьте его вместе с ИНН организации для получения лицензии.

Ограничения версии 1.0

• Загрузка данных поддерживается в реквизиты шапки справочников/документов и в регистры сведений. Загрузка в табличные части появится в следующих версиях.
• Собственная форма расписания в Апитете рассчитана на быстрые базовые сценарии (ежедневно / с интервалом в течение дня). Для более сложных схем расписания (конкретные дни недели, ежемесячно) используйте штатный интерфейс платформы "Регламентные и фоновые задания".