Update swagger spec to valid OAS3 format

decentralized-identity / sidetree

Sidetree Specification and Reference Implementation

https://identity.foundation/sidetree/spec

Apache License 2.0

438 stars 112 forks source link

Update swagger spec to valid OAS3 format #787

Closed tmarkovski closed 4 years ago

tmarkovski commented 4 years ago

Signed-off-by: Tomislav Markovski tmarkovski@gmail.com

Updated swagger to be valid OAS3 spec. Consolidated error response in a single schema. Moved individual error codes to description. This allows generators to correctly generate code. In addition, strongly typed languages generally prefer defined models in components, instead inline schema.

I tested this with autorest and NSwag, generated C# and typescript code, it looked fine.

OR13 commented 4 years ago

@tmarkovski thanks for these awesome changes!