3 ms·
It is verbose, You often need to define type twice in Open API definition and in Java/Typescript. In addition, swagger UI is not very good. Tooling like editor
by Chyzwar 5y ago
It is verbose, You often need to define type twice in Open API definition and in Java/Typescript. In addition, swagger UI is not very good. Tooling like editor support, testing, benchmarking is lacking compared to even Postman.
In most cases, there is plenty of good alternatives:
- Sharing types
- API/SDK client libraries
- GraphQL
- gRPC
- hasura/postgrest
- Postman
The only good use case for Swagger/OpenAPI is when you need to expose API to third parties, but even then the above solutions can also be applied.