do you use WebAPI specification formats?

twitter logo github logo ・1 min read

Do you use a formal specification for WebAPIs? Such as Swagger/OpenApi or JSON Schema or other formats?

Do you use it for documentation only or do you use it in code, e.g. for the validation of payload or other things?

Please help and fill the poll or leave a comment below.

Thanks for reading.

twitter logo DISCUSS (4)
markdown guide

Thanks for sharing.

Would you appreciate a small tool that helps to generate validation code out of your OpenAPI specs?


What do you mean? Validation of the API response?

Well more the payload in the response.

Imagine you are getting some json data, it often ends up in a dto.
But before it gets there the data must be validated against the API Spec so that the existence of fields and the format of the fields etc. matches the expectations.
And often even more it must be validated against some business rules once it passed the format checks. That is a lot of boiler plate and some logic in code is duplicated in the API Spec.

Classic DEV Post from Jan 31

9 Rules of Effective Development Team Meetings

If you are developer frustrated by meetings at work, then read this article and learn how you can fix meetings with these four simple rules. How to make your development meetings effective again!

Sven Assmann profile image
polyglot software engineer, mainly on web technologies since 2006. Like to explore new things and toy around with languages, frameworks and problems.

Do you prefer sans serif over serif?

You can change your font preferences in the "misc" section of your settings. ❤️