Конструктор API для обмена базы 1С 8.3 с другими системами по протоколу http в формате JSON

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки.

Арт.: 2194391

Лицензии

24000 руб.

Техподдержка и обновления

5000 руб.

Область применения

Расширение позволяет легко организовать доступ к данным 1С. Отдать данные из 1С возможно без единой строки программного кода. Достаточно конструктора схемы компоновки данных (СКД).
Может принимать и отдавать данные по протоколу json-rpc или из адресной строки браузера.

Расширение превращает 1С в безголовую систему управления сайтом (Headless CMS).

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

Поддерживает работу с планами обмена и может отдавать только изменённые данные.

Архив поставки содержит демо базу, где показаны варианты организации данных.

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

Расширение совместимо со всеми конфигурациями на платформе 8.3, которые возможно запустить с управляемыми формами.

Внимание! Расширение не работает на БАЗОВЫХ конфигурациях (в базовых конфигурациях 1С, возможности подключения расширений - отсутствуют)!

Полностью открытый код, не требует наличия каких-либо объектов метаданных.

Функциональные возможности

В расширении описываются правила обмена. В каждом правиле указываются поля, а также алгоритмы чтения из 1С, записи и отправки. Корреспондирующий системы должны поддерживать такие же правила.
В одной базе возможно описать несколько наборов правил. Каждый набор представляет собой api. Правила объединяются в наборы с помощью плана синхронизации.
Обмен только изменёнными данными возможен при использовании планов обмена. Для этого в каждом правиле необходимо указать объект метаданных и узел обмена для отслеживания изменений.

Пример описания API
 

Поддерживается три варианта работы

  1. API с передачей параметров в адресной строке.
  2. API по протоколу json-rpc. При таком подходе адрес для обращения всегда один, а имя правила и параметры передаются в запросе json-rpc.
  3. Подход web hook подразумевает отправку данных по инициативе системы. Может отправлять накопленные данные по расписанию или по запросу. Такой подход удобен, когда система «знает» какие данные нужны корреспондирующей системе. Обмен идёт по протоколу json-rpc. Получение подобных запросов не отличается от пункта 2. Отправка требует указания адреса корреспондирующей системы.

Работа с из браузера

Адрес для получения данных в общем виде выглядит так:

https://server1s/baza/hs/lemurr/data/80213a3c-6a2d-11ef-825d-f43bd8ccef6b/json/100/200?k=123456&n=1

где:

  • https — протокол. Для обеспечения безопасности расширение требует защищенный протокол, шифрующий и адресную строку и тело запроса.
  • server1s — имя web сервера, на котором опубликован http сервис.
  • baza — имя базы 1С на web сервере
  • hs — признак того, что обращаемся к http сервису
  • lemurr — имя http сервиса
  • data — признак того, что требуется получить данные. Вместо этого параметра можно указать md для получения описания api.
  • 80213a3c-6a2d-11ef-825d-f43bd8ccef6b — идентификатор правила синхронизации.
  • json — формат в котором требуется вернуть данные. Возможно указать html, тогда решение вернёт данные в виде html страницы. Возможность получить html предусмотрена только для отладки, в практической работе смысла не имеет.
  • 100 — количество записей, которое должен вернуть алгоритм.
  • 200 — с какой записи начать отсчёт. Этот параметр предназначен для постраничного просмотра.

После вопросительного знака идут параметры

  • k — ключ плана синхронизации. Указывается в справочнике планов синхронизации. По этому ключу расширение находит план, с которым связаны правила синхронизации.
  • n — признак того, что необходимо вернуть только изменённые данные. Продукт снимет признак изменённости с отданных объектов. Для повторного получения потребуется установить этот флаг в базе 1С.

Получить описание API можно запросом такого вида: https://server1s/baza/hs/lemurr/md/json?k=123456.

В удобочитаемом для человека виде описание можно получить запросом: https://server1s/baza/hs/lemurr/md/html?k=123456

Запрос по адресу https://server1s/baza/hs/lemurr?k=123456 инициирует отправку данных корреспондирующим системам на адрес, указанный в плане синхронизации.

Ответ на curl запрос:

Запрос на запись

 

curl -X POST -T "zapis.json" https://server1s/baza/hs/lemurr/data/80213a3c-6a2d-11ef-825d-f43bd8ccef6b/json?k=123456


В файле zapis.json передаются значения для записи в базу 1С.

{"Наименование": "1С:Упрощенка 8",

"Артикул": "4601546048264",

"ПолноеНаименование": "1С:Упрощенка 8"}

Алгоритм исполнит скрипт обработки загрузки, передав ему полученные данные.

JSON-RPC

Работа в формате json-rpc идет только POST запросами. Адрес всегда один.
https://server1s/baza/hs/lemurr?k=123456
123456 — ключ плана синхронизации.

Получить описание API можно, отправив запрос вида

{

"jsonrpc": "2.0",

"method": "__описание__",

"params": null,

"id": "произвольный идентификатор"

}

__описание__ — зарезервированное слово для получения описания API.

Видеоинструкция по установке расширения

Техническая поддержка и обновления

Бесплатный период техподдержки составляет 1 месяц со дня покупки.

Также после приобретения вы получаете 6 месяцев бесплатных обновлений.

По окончании бесплатного периода вы можете приобрести услугу технической поддержки с доступом к обновлениям на платной основе.

Проверить наличие обновлений можно в личном кабинете. Если обновления недоступны - загрузить новую версию можно после покупки обновлений/технической поддержки.

Задать вопрос по программе можно по кнопке "Техподдержка" на странице описания.

При создании тикета необходимо предоставить:

  1. Номер заказа
  2. Описание вопроса. Если это ошибки - напишите порядок ваших действий с программой, которые к ней привели (приложите видео/скриншоты/отчеты об ошибке)
  3. Точную конфигурацию 1С, и версию платформы, на которой используете купленное решение (наименование и версию 1С можно взять из раздела "О программе"), версию купленной программы.

К созданной заявке подключается специалист. Дальнейшее обсуждение проблемы будет проходить в тикете техподдержки. Стандартный срок реакции - 24 часа в рабочие дни с момента обращения.

 

Техподдержка
 

Статистика:
Просмотры 747
Загрузки 0
Рейтинг 2
Создание 27.09.24 15:45
Обновление 27.09.24 15:45
№ Публикации 2194391
Характеристики:
Теги

json-rpc api интеграция

Рубрики WEB-интеграция
Кому Программист ,
Руководитель проекта
Тип файла Архив с данными
Платформа Платформа 1С v8.3
Конфигурация Конфигурации 1cv8
Операционная система Не имеет значения
Страна Не имеет значения
Отрасль Не имеет значения ,
1С:Франчайзи, автоматизация бизнеса
Налоги Не имеет значения
Вид учета Не имеет значения
Доступ к файлу Платные (руб)
Код открыт Да

Оставьте свое сообщение

См. также

Модуль для интеграции с маркетплейсами - Wildberries, Ozon, Лемана Про, Aliexpress,Яндекс Маркет, Мегамаркет, Авито, Lamodа

Функциональное решение для торговли на всех популярных маркетплейсах. Работает со схемами FBO и FBS. Простое в использовании и установке, не вносит изменения в код программы. Существенно упрощает работу с товарным ассортиментом, обработку з...

72000 руб.

Интеграция с сервисом vetmanager в 1С: Бухгалтерия 3.0

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

Модуль для обмена "1С:Предприятие 8. УАТ. ПРОФ" с FortMonitor

Расширение предназначено для конфигурации "1С:Предприятие 8. Управление Автотранспортом. ПРОФ". Функционал модуля: 1. Заполнение регистров сведений по подсистеме "Мониторинг", а именно: события по мониторингу, координа...

22656 руб.

Драйвер облачной кассы для Бизнес.РУ Чеки

Универсальный драйвер для фискализации чеков для сервиса Бизнес.РУ. Чеки (https://online-check.business.ru/). Работает с любой кассой, подключенной к сервису, в том числе и без физической кассы (Аренда облачной ККТ в датацентре). Принцип ра...

6000 руб.