Skip to content

Finally add an OpenAPI spec for the OCS Endpoints#4657

Merged
dartcafe merged 5 commits intomainfrom
enh/open-api
Apr 28, 2026
Merged

Finally add an OpenAPI spec for the OCS Endpoints#4657
dartcafe merged 5 commits intomainfrom
enh/open-api

Conversation

@dartcafe
Copy link
Copy Markdown
Collaborator

@dartcafe dartcafe commented Apr 28, 2026

Finished a long standing task to proper document the OCS endpoints

  • Added OpenAPI specifications (openapi.json, openapi-administration.json, openapi-full.json) generated from source annotations via nextcloud/openapi-extractor
  • Replace outdated and buggy API documentation
  • Added Capabilities instead of the enum endpoints
  • Added composer script openapi
  • Enabled psalm to check the validity of the spec against the code

Signed-off-by: dartcafe <github@dartcafe.de>
Signed-off-by: dartcafe <github@dartcafe.de>
Signed-off-by: dartcafe <github@dartcafe.de>
Signed-off-by: dartcafe <github@dartcafe.de>
Signed-off-by: dartcafe <github@dartcafe.de>
@dartcafe dartcafe changed the title A new try of a working OpenAPI implementation Finally add an OpenAPI spec for the OCS Endpoints Apr 28, 2026
@dartcafe dartcafe added this to the 9.0.5 milestone Apr 28, 2026
@dartcafe dartcafe merged commit fb5c055 into main Apr 28, 2026
48 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant