search

cs3org / OCM-API

OpenCloudMesh API
38 stars 11 forks source link

Convert to OpenAPI 3.0 #64

Closed smesterheide closed 5 months ago

smesterheide commented 1 year ago

I used the Swagger Editor to convert the specification to OpenAPI 3.0

smesterheide commented 1 year ago

Here is the preview for this PR using the redoc CDN with the latest version (v2.0.0-alpha): https://smesterheide.github.io/OCM-API/docs.html?branch=openapi-3&repo=OCM-API&user=smesterheide

michielbdejong commented 1 year ago

Nice! Looking forward to seeing this merged

glpatcern commented 1 year ago

Can we please get https://github.com/cs3org/OCM-API/pull/59 merged before this large refactoring?

I intended to also specify what is required vs optional in a more detailed way, but that could be done after this, using the new 3.0 format.

smesterheide commented 1 year ago

Sure, I still need to to manually check if everything was converted correctly, hence the draft.

glpatcern commented 5 months ago

Closing in favor of #83, given that meanwhile the spec had evolved quite a bit and this PR remained behind. Please reopen if you think we should use part of this.