Организация 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.

 

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

Вступайте в нашу телеграмм-группу Инфостарт

См. также

Оптовая торговля Розничная торговля WEB-интеграция 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Платные (руб)

Предоставьте вашим b2b-клиентам и дилерам круглосуточный доступ к актуальному ассортименту, ценам и остаткам. Автоматизируйте прием заказов и разгрузите менеджеров с помощью готовой <strong>веб-витрины</strong>, интегрированной с 1С в режиме реального времени

57600 руб.

26.11.2024    6562    4    3    

7

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

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

36000 руб.

03.08.2020    21624    30    24    

24

SALE! 15%

WEB-интеграция Программист Бизнес-аналитик 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

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

17280 14688 руб.

20.12.2024    3851    18    2    

20

WEB-интеграция Программист Руководитель проекта 1С v8.3 1C:Бухгалтерия 1С:Франчайзи, автоматизация бизнеса Платные (руб)

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки. Основные преимущества: 1. Документация API создаётся автоматически. Удобна для программной обработки. 2. Изменить API столь же просто как настроить отчёт. Можно опубликовать существующий вариант отчёта. 3. Отчёты в API поддерживают параметры (Период, ДатаНачала и др.) 4. При создании простых методов не требуется изменять конфигурацию. 5. Поддерживается работа с планами обмена.<br/> 6. Возможно настроить отправку из 1С данных корреспондирующей системе, для случаев когда 1С сама "знает" какие данные нужно отправить. 7. После записи в 1С Ле Мурр может возвращать соответствие полученных идентификаторов созданным в 1С объектам данных.

36000 руб.

27.09.2024    8388    7    5    

9

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

В расширении реализован механизм интеграции между системой поставщика и Личным кабинетом СДТ. Реализован обмен заказами и реализациями (накладными), предусмотрено отслеживание статусов документов. Расширение предназначено для 1С:УТ 11.4.

35856 руб.

27.11.2024    2073    1    0    

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