Пустынный Александр. Инженер-программист

SAKURA.AERO это автоматизированная система учета продаж поездок, проживаний, страховок от разных поставщиков. Поэтому важно обеспечить доставку этих документов из внешних систем клиента в автоматическом режиме. Рабочее место кассира в системе SAKURA.AERO это модуль "Билетный кассир". Он позволяет записывать билеты в ручном режиме, но это долгий процесс ввода всех данных услуги и ее получателя. Поэтому клиентам настраивается автоматическая доставка продаж. Почти все поставщики имеют как минимум один способ доставки. Как же достигается в SAKURA.AERO автоматизация подтягивания билетов? Классический пример...

Перевод пункта 4.2 OpenAPI Specification. Open API документ, соответствующий спецификации OpenAPI, является объектом JSON и может быть представлен либо в формате JSON, либо в формате YAML. Например, если поле имеет значение массива, то будет использоваться представление массива JSON: { "field": [ 1, 2, 3 ] } Все названия полей в спецификации чувствительны к регистру (case sensitive). Это относится ко всем полям, которые используются в качестве ключей в карте, за исключением тех случаев, когда указано обратное (case insensitive). Схема предоставляет два типа полей: Шаблонные поля ДОЛЖНЫ иметь уникальные имена внутри содержащего их объекта...

Я часто работаю с запросами к api различных сервисов предоставляющих данные о проданных билетах, забронированных отелях и другие. А так как работаю в основном с российскими сервисами, то данные возвращаемые этими api почти всегда содержат кириллицу. В ответах кириллические символы приходят как "\u0410\u043b\u0435\u043a\u0441\u0435\u0439". Как получить из запроса читаемый текст, я уже писал статью. Но иногда приходится иметь дело с файлами, данные в которых уже сохранены с нечитаемыми значениями на кириллице. К этом случае я рекомендую использовать другой инструмент доступный в VSCode. Это JSON Escaper...

Если у вашего бэка все методы даже не заполняют окно редактора, и вы сами пишете фронт, то можно и не документировать, если этого не требует заказчик. Если разработчики бэк и фронт частей разные, то над документированием уже стоит не только задумываться, но и начать реализовывать. О размещение документации в этой статье говорить не будем, но в подборке материалы конечно же будут. Зачем? Вот я, например, запушил по заявке новый функционал, который нужно передать фронтэнд разработчику. Я начинаю писать...