OpenAPI на практике: пошаговое руководство

OpenAPI — это открытая спецификация для описания REST API. Изначально она называлась Swagger, но в 2016 году была переименована в OpenAPI Specification и передана под управление OpenAPI Initiative. На данный момент Swagger — это набор инструментов для работы со спецификацией OpenAPI (Swagger UI, Editor, Codegen). В OpenAPI определяются пути, параметры, тела запросов и ответов, коды статусов, схемы данных, типы аутентификации. В статье мы рассмотрим спецификацию OpenAPI версии 3.0: разберем из каких обязательных блоков она состоит и как правильно описывать типы данных и параметры запросов.

https://habr.com/ru/companies/first/articles/973186/

#документация #open_api #проектирование_api #подготовка_технической_документации #документирование_api

Полуприподоткрытый API. Истории от команды, которая прошла через 10+ API-интеграций с банками

Решил немного рассказать о нашем опыте API-интеграций с крупными российскими банками. За почти шесть лет работы компании мы провели их уже больше десяти, и поделиться есть чем.

https://habr.com/ru/articles/926660/

#APIинтеграция #open_api #public_api

Scalar на замену Swashbuckle в .NET 9 и как это готовить с Design API First

Рассказываю чем заменить Swashbuckle, который убрали из .Net 9, для создания страницы похожей на Swagger UI.

https://habr.com/ru/articles/904738/

#web_api #aspnet_core #swagger #open_api #net_9 #dotnet_core #dotnet #typespec #webapi #openapi