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 May 10

Discuss: GitHub Special Event

GitHub is holding a "GitHub Special Event" today. Let's discuss what we're thinking leading up to it + while it's happening <3

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

Sore eyes?

dev.to now has dark mode.

Go to the "misc" section of your settings and select night theme ❀️