kafka-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Arthur <mum...@gmail.com>
Subject versionId in responses (and general API versioning questions)
Date Wed, 13 Feb 2013 20:48:57 GMT
Just noticed that most of the API response structs do not include the 
ApiVersion. This will make it hard for clients to determine how to 
handle responses once the APIs start getting updated (which is pretty 
much inevitable).

I'd propose we update the standard response envelope to include it

Response => ApiVersion CorrelationId ResponseMessage
   ApiVersion => int16
   CorrelationId => int32
   ResponseMessage => ...

Otherwise, it seems we must freeze the response formats forever.

Another thought is that the server should return the same version of the 
API that was requested (if a client sends in v1, then presumably it does 
know about any future versions...). How will this work? This seems to 
imply backwards compat for the APIs like Avro.

Thoughts?

-David

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message