search

scylladb / scylladb

NoSQL data store using the seastar framework, compatible with Apache Cassandra
http://scylladb.com
GNU Affero General Public License v3.0
13.51k stars 1.29k forks source link

RFC: Convert ScyllaDB admin REST to OpenAPI 3.0 #18028

Open tzach opened 7 months ago

tzach commented 7 months ago

The current API specs (https://github.com/scylladb/scylla/tree/master/api/api-doc) follow the old Swagger 1.2 specs. The old version makes the spec use with the latest tools and libraries, for example in docs (see #8180) and UI.

It is desirable to move to the latest OpenAPI v3 spec.

mykaul commented 7 months ago

@piodul - is that in your team's domain? Note - we'd like to fully support it (and thus document it) eventually, so I'd be happy to understand what the effort required here is.

mykaul commented 7 months ago

(Optimistically setting this to 6.1)

piodul commented 7 months ago

@mykaul I think it's more of @ptrsmrn's team's domain (REST API is frontend).

I remember that @Lorak-mmk did some exploration in this area long time ago, in context of his proposal to move nodetool to Rust, so ccing him in this sentence.