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

13

SALE! 10%

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

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

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

28000 25200 руб.

28.05.2015    84930    28    51    

50

Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС

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

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

2400 руб.

28.04.2016    89062    163    216    

319

[Расширение] БОР-Навигатор.Культура

Зарплата Бюджетный учет WEB-интеграция Обмен с ГосИС Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бюджетный учет Платные (руб)

Расширение конфигурации, включающее в себя объекты, необходимые для подготовки и сдачи отчета "Штатная численность" системы "БОР-Навигатор.Культура" в программе "1С:Зарплата и кадры государственного учреждения", редакция 3.1.

8400 руб.

01.02.2019    25898    9    0    

7

Интеграция с сервисом vetmanager

WEB-интеграция Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

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

12000 руб.

02.02.2021    16502    42    49    

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