Организация HTTP публикации каталога товаров используя PostgREST

26.05.22

Интеграция - WEB-интеграция

В статье опишу порядок установки настройки и использования PostgREST на примере организации каталога товаров.

Вводные

  • Торговая компания работающая в сфере B2B
  • Нужно опубликовать каталог товаров для автоматической загрузки данных из него в базы клиентов
    • Группы номенклатуры
    • Номенклатура
    • Цены
    • Остатки

На мысль о данной реализации навела статья //infostart.ru/1c/articles/1217831/, но в ней больше описано про подход и реализацию со стороны 1С. В своей статье опишу настройку сервиса, формирование БД, настройку доступа и обращение по HTTP.

 

Вариант реализации

 

Установка сервиса PostgREST

Разворачивать сервис буду на VDS с Ubuntu 20.04, хостинг digitalocean.

Подключаюсь к серверу по SSH с помощью PuTTY (ссылка) используя SSL ключ (ссылка). Ключ можно указать в настройках подключения, так и загрузить в Pageant из группы программ PuTTY. Ключ в дальнейшем буду использовать для подключения к PostgreSQL через SSH туннель.

 
 Добавляю разрешения в брандмауэр, включаю его

 

Для работы потребуется PostgreSQL (PG), для Ubuntu 20.04, PostgREST поддерживает версию 9.4 и выше, в стандартных репозиториях ubuntu 12 версия. Инструкция по установке https://www.digitalocean.com/community/tutorials/how-to-install-postgresql-on-ubuntu-20-04-quickstart-ru

# Устанавливаем postgres
sudo apt install postgresql postgresql-contrib
 
 
 Устанавливаю пароль пользователя, добавляю схему

 

Для подключения к базе PG с рабочего места использую DBeaver https://dbeaver.io/, (ссылка на видео по функционалу). При подключении использую SSH туннель с SSL ключом.

 
 Скриншоты настройки подключения

 

Сервис будет работать на PostgREST http://postgrest.org/en/v7.0.0/
 
Для работы сервиса PostgREST буду использовать отдельного пользователя с ограниченными правами (ссылка на статью по теме).
# Добавляю пользователя ubuntu
adduser pgadmin

# указываю пароль и остальные параметры
 

Приложение PostgREST поставляется в виде бинарного файла и запускается с параметрами подключения, которые можно зафиксировать в конфигурационном файле, пример файла можно получить запустив ./postgres --help

Получаем ссылку на архив по ссылке https://github.com/PostgREST/postgrest/releases/latest (ссылка на документацию)

UPD: Если используете PG14, то нужная версия v9.0.0 и выше

 
 Получение приложения, настройка

 

Создаем, запускаем службу (ссылка, раздел Daemonizing)

 
 Настройка службы linux

 

Служба работает на 3000 порту, опубликуем её на 80 используя nginx

 
 Установка, настройка nginx

 

Проверяем подключение.

 
 скриншот

 

Создание структуры базы данных

 
 Запрос создания таблицы

 

При изменении строк фиксирую дату изменения, это реализовано через триггеры (документация) (ссылка на статью по теме)

 
 Запросы создания функции и подключения к таблице через триггеры

 

Заполняю тестовыми данными, для этого использую https://www.mockaroo.com/

 
 Скриншот настройки генерации

 

Полученный файл запускаю через DBeaver.

 

Настройка прав доступа

(Ссылка на урок)

Добавляю права доступа для web_anon на чтение таблицы api.products

grant select on api.products to web_anon;

 

Проверяю результат

 
 Скриншот HTTP запроса

 

Добавляю пользователя с правом записи

 
 SQL команды

 

Для аутентификации на уровне PostgREST используется JWT формата HS256 (статья по работе из 1С) , ключ фиксируется в конфигурационном файле.

 
 Добавление настройки JWT ключа

 

Токен можно сгенерировать используя сервис https://jwt.io/, результат помещается в заголовок HTTP запроса 

"Authorization: Bearer $JWT_TOKEN"

 

В теле запроса на получение токена указывается поле "role", для которой выдается токен. При таком подходе токен будет бессрочным, что затрудняет его отзыв. Для решения вопроса можно добавить поле "exp" указывающее на время истечения токена.

 
 Скриншот с примером генерации ключа

 

Для большей гибкости можно использовать параметры из тела JWT токена, пример ограничения доступа по email

 
 Команды SQL

 

 
 Добавляем использование функции в настройки сервиса

 

При формировании токена в тело добавляем параметр email

{
  "role": "todo_user",
  "email": "disgruntled@mycompany.com"
}

Эти данные можно использовать в представлениях для отбора, например цены по доступным для пользователя с email.

 

Добавление, обновление данных

(Ссылка на документацию)

Для добавления данных используется POST запрос с JSON в теле запроса, поддерживается групповая загрузка, пример

[
  {"name":"Chicken - Leg, Fresh","unit_name":"шт","price":57,"count":97},
  {"name":"Chicken Giblets","unit_name":"шт","price":100,"count":25}
]

Для обновления данных используется PATCH, в параметрах запроса указывается идентификатор, например "?id=eq.1002" в теле обновляемые поля, например

{
  "price":10020
}

 

Итог

С помощью PostgREST можно организовать сервис работы с данными использующий функционал Postgres с удобной оберткой в HTTP.

 

Благодарю за внимание.

См. также

Интеграция Альфа Авто 5 / Альфа Авто 6 и AUTOCRM / Инфотек

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

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020    16344    14    18    

15

Интеграция 1С и Битрикс 24 — модуль синхронизации для обмена задачами

Сайты и интернет-магазины Интеграция WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 Управленческий учет Платные (руб)

Интеграция 1С и Битрикс 24. Разработка имеет двухстороннюю синхронизацию 1С и Bitrix24 задачами. Решение позволяет создавать пользователя в 1С из Битрикс24 и наоборот. Данная разработка технически подходит под все основные конфигурации линейки продуктов 1С:Предприятие 8.3 (платформа начиная с 8.3.23). При приобретении предоставляется 1 месяц бесплатных обновлений разработки. Доступна демо-версия продукта с подключением Вашего Битрикс24

5040 руб.

04.05.2021    18568    10    15    

16

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

WEB-интеграция 8.3.8 Конфигурации 1cv8 Автомобили, автосервисы Беларусь Украина Россия Казахстан Управленческий учет Платные (руб)

Расширение предназначено для конфигурации "1С:Предприятие 8. Управление Автотранспортом. ПРОФ". Функционал модуля: 1. Заполнение регистров сведений по подсистеме "Мониторинг", а именно: события по мониторингу, координаты по мониторингу, пробег и расход по мониторингу, текущее местоположение ТС по мониторингу 2. Заполнение путевого листа: пробег по мониторингу, время выезда/заезда, табличная часть ГСМ, места стоянок по геозонам. 3. Отчеты по данным загруженным в регистры сведений. 4. Предусмотрена автоматическая загрузка данных в фоновом режиме (условия работы данной загрузке читайте в описании товара) Модуль работает без включенной константы по настройкам мониторинга. Модуль формы предоставляется с открытым кодом, общий модуль защищен. Любой заинтересованный пользователь, имеет возможность скачать демо-версию расширения.

22656 руб.

25.05.2021    13145    35    8    

14

Автоматическая загрузка файлов (например, прайс-листов) из электронной почты, FTP, HTTP, их обработка и выгрузка на FTP (на сайт) и для других целей

Прайсы WEB-интеграция Ценообразование, анализ цен Файловый обмен (TXT, XML, DBF), FTP Системный администратор Программист Автомобили, автосервисы Оптовая торговля, дистрибуция, логистика Управленческий учет Платные (руб)

Программа с заданным интервалом времени (или по ручной команде) скачивает файлы (например, прайс-листы поставщиков) из различных источников: письма электронной почты, FTP или HTTP-адреса, и сохраняет их в каталог упорядоченной структуры. При этом извлекает файлы из архивов, может переименовывать файлы и менять их формат (csv, xls, txt). Можно настроить выгрузку обработанных файлов на сайт (через FTP-подключение). Программа будет полезна компаниям, у которых есть большое количество поставщиков и/или прайс-листы поставщиков обновляются часто (необязательно прайс-листы, файлы могут быть любого назначения). Собранные таким образом актуальные версии прайс-листов можно выгрузить с помощью программы себе на сайт (или на любой FTP-сервер) или выполнить другие необходимые задачи.

25200 руб.

28.05.2015    85965    26    51    

50
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. Tahallus 441 05.10.20 13:21 Сейчас в теме
А что за Ubuntu 20.20 ? Есть Ubuntu 20.04 вроде пока.
2. malikov_pro 1306 05.10.20 14:34 Сейчас в теме
Оставьте свое сообщение