Если вы все еще не используете язык определения для машиночитаемых спецификаций API, например OpenAPI (ранее известный как Swagger), вам определенно следует подумать об этом. В конце концов, API - это языки, на которых машины общаются друг с другом.
Сваггер - хорошая идея?
Swagger производит очень хорошее первое впечатление Кроме того, многие люди считают, что возможность генерировать код из документации – это хорошая идея, и Swagger это обеспечивает также. Таким образом, тот факт, что чванство производит отличное первое впечатление, делает его ограничения менее очевидными.
Какова цель использования Swagger?
Swagger позволяет вам описать структуру ваших API, чтобы машины могли их читать. Способность API-интерфейсов описывать свою собственную структуру - корень всего удивительного в Swagger.
Сваггер все еще используется?
Сегодня многие пользователи по-прежнему используют термины « Swagger» для обозначения формата спецификации OpenAPI 2.0 и «Swagger spec» для обозначения документа с описанием API в этом формате.. RepreZen API Studio использует эти термины в некоторых частях пользовательского интерфейса, но называет OpenAPI 3.0 и более поздние версии «OpenAPI».
Является ли swagger только для REST API?
Спецификация OpenAPI (ранее - Спецификация Swagger) - это формат описания API для REST API. Файл OpenAPI позволяет вам описать весь ваш API, включая: Доступные конечные точки (/users) и операции с каждой конечной точкой (GET /users, POST /users)
