Mickael Maison created KAFKA-20391:
--------------------------------------

             Summary: Improve types returned by the Connect REST API
                 Key: KAFKA-20391
                 URL: https://issues.apache.org/jira/browse/KAFKA-20391
             Project: Kafka
          Issue Type: Improvement
          Components: connect
            Reporter: Mickael Maison


A bunch of our Connnect REST API endpoints defined in 
org.apache.kafka.connect.runtime.rest.resources use Response as the return 
type. This makes our OpenAPI spec not very useful as it does not describe the 
output types.

ConnectorPluginsResource is a good example as it fully describes all return 
types. On the other hand, all endpoints in LoggingResource return the generic 
Response type so the generated OpenAPI spec is pretty much useless.

We should be able to update most return types without causing any 
behavior/compatibility changes and greatly improving our OpenAPI spec.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to