Организация 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С v8.3 1C:Бухгалтерия 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

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

36000 руб.

03.08.2020    21856    32    24    

25

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    4071    20    2    

21

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    8999    7    5    

10

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

Обмен данными с "Порталом поставщиков" zakupki.mos.ru Москвы и Московской области с целью создания оферт для закупок государственными учреждениями. Модуль устраняет рутину, минимизирует ошибки и помогает выигрывать больше закупок. Работает строго по требованиям 44-ФЗ.

14400 руб.

13.12.2016    41382    54    39    

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