Ако все още не използвате език за дефиниция за машинно четими API спецификации, като OpenAPI (известен преди като Swagger), определено трябва да помислите да го направите. В крайна сметка API са езици, на които машините могат да говорят помежду си.
Swagger добра идея ли е?
Swagger прави много добро първо впечатление Освен това много хора смятат, че възможността за генериране на код от документацията е добра идея и Swagger предоставя, че също така. Така че фактът, че размахът прави страхотно първо впечатление, прави неговите ограничения и ограничения по-малко очевидни.
Каква е целта на използването на Swagger?
Swagger ви позволява да опишете структурата на вашите API, така че машините да могат да ги четат. Способността на приложните програмни интерфейси (API) да описват собствената си структура е в основата на цялата страхотност в Swagger.
Използва ли се все още Swagger?
Днес много потребители все още използват термините " Swagger" за обозначаване на формата за спецификация на OpenAPI 2.0 и "Swagger spec" за препратка към документ с описание на API в този формат. RepreZen API Studio използва тези термини в някои части на потребителския интерфейс, но се позовава на OpenAPI 3.0 и по-нови версии като "OpenAPI. "
Swagger само за REST API?
OpenAPI Specification (по-рано Swagger Specification) е формат за описание на API за REST API. OpenAPI файл ви позволява да опишете целия си API, включително: Налични крайни точки (/users) и операции на всяка крайна точка (GET /users, POST /users)
