В предыдущих постах:
+ Рассказала про маппинг,
+ Влияние интеграций на БД,
+ Показала БД проекта (предыдущий пост)
Чтобы показать пример маппинга, нужно определиться, для какой постановки задачи мы его делаем:
👉 Если на Frontend, то показываем соответствие данных между:
- UI,
- API ShipEasyGA.
Frontend вообще не надо знать какие интеграции есть “под капотом” и лишние детали для Frontend-разработчиков в постановке задачи не показываем.
👉 Если на Backend, для реализации API-метода ShipEasyGA, то показываем соответствие данных между:
- API ShipEasyGA,
- API внешней системы DaData,
- БД, если для работы API нужно читать данные из БД или сохранять их в неё.
В документе, который я прикрепила к этому посту, я показываю маппинг данных для Backend, на разработку API-метода, который будет получать структурированные адреса по введенной строке, но ничего не будет сохранять в БД.
GET /address?text=’строка адреса’&type='pickup/delivery'
Это интеграционный API-метод.
Также, чтобы оптимизировать работу метода, если его вызвали без передачи строки text или она пустая, то предлагается показывать клиенту ShopEasyGA 5 последних адресов из БД (таблица address), которые он использовал для других заказов, если они есть в БД.
Файл с примером маппинга прикреплен к посту 📖
Это часть постановки задачи на интеграционный API-метод.
#ИнтеграцииGA