Se você ainda não estiver usando uma linguagem de definição para especificações de API legíveis por máquina, como OpenAPI (anteriormente conhecido como Swagger), você deve definitivamente considerar fazê-lo. Afinal, APIs são linguagens para as máquinas se comunicarem.
Swagger é uma boa ideia?
O Swagger causa uma primeira impressão muito boa Além disso, muitas pessoas pensam que a possibilidade de gerar código a partir da documentação é uma boa ideia e o Swagger fornece isso também. Portanto, o fato de a arrogância causar uma ótima primeira impressão torna suas limitações e restrições menos aparentes.
Qual é o propósito de usar o Swagger?
Swagger permite que você descreva a estrutura de suas APIs para que as máquinas possam lê-las. A capacidade das APIs de descrever sua própria estrutura é a raiz de toda grandiosidade no Swagger.
O Swagger ainda é usado?
Hoje, muitos usuários ainda usam os termos " Swagger" para se referir ao formato OpenAPI 2.0 Specification e "Swagger spec" para se referir a um documento de descrição de API neste formato. O RepreZen API Studio usa esses termos em algumas partes da interface do usuário, mas se refere ao OpenAPI 3.0 e versões posteriores como "OpenAPI. "
Swagger é apenas para API REST?
OpenAPI Specification (anteriormente Swagger Specification) é um formato de descrição de API para APIs REST. Um arquivo OpenAPI permite que você descreva toda a sua API, incluindo: Endpoints disponíveis (/users) e operações em cada endpoint (GET /users, POST /users)
