другое? поделитесь кто что для рисования диаграм использует?
plantuml
пейнт
app diagram net
этот тот же draw.io
miro
я тут решил все-таки подружиться с генерацией кода из openapi 2.0 пишу спеку и дошел по запроса получения списка сущностей с фильтрацией. Задача: получения списка сущностей с фильтрацией по полям. когда руками делал, то фильтраци была через query параметры, аля field[operator]=value, например: created_at[gt]=2021-11-10 а на месте gt могут быть разные операторы, типа lt, lte, gte. в спеке openapi так не сделать. когда я с такой проблемой столкнулся в gRPC, то я всю фильтрацию занес в message реквеста, FindAllEntitiesRequest и написал свои messages для фильтрации по строковому полю: StringFieldFilter, для фильтрации по числовому полю: IntFieldFilter и так далее. получается в случае спеки openapi также делать? или я что-то упускаю.
вот это поперек стандарта же: field[operator]=value можно сделать так же, как в grpc, да
А вы, мисье, знаете толк в извращениях
не нашел где стандарт говорит что низзя использовать [] в ключах query параметрах
говорит ли он что-нибудь о том, что эти [] интерпретируются иначе, как просто символы?
нет. так мне и надо интерпретировать их как строку, а там уж шаловливые ручки парсер написали)))
Тут ещё стоит учесть, что можно вылезти за длину урла. Попадали, знаем.
когда такое возможно, конечно данные улетают в body, просто это чистый REST API, с логикой на основе кодов ответа транспорта HTTP и там фильтрация, очевидно на query параметрах.
помнишь был вопрос, чего не хватает в openapi 2.0 по сравнению с 3.0, кроме callback’ов? вот нашел: операторов oneOf, allOf, anyOf ;)
Да, это правда Но жить без них можно. Более того, без них протокол получается чище
но вот у меня поле Name в фильтрации, для него можно применить как StringFieldFilter так и StringArrayFiledFilter и сейчас придется жонглировать обязательностью полей, а так было бы очень красиво с oneOf, ведь в gRPC у меня это oneOf
А аутентификации там хватает, точно?) в 2.0 только basic auth вроде было
Обсуждают сегодня