<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Aug 28, 2014 at 9:29 AM, Daniel Bevenius <span dir="ltr">&lt;<a href="mailto:daniel.bevenius@gmail.com" target="_blank">daniel.bevenius@gmail.com</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="">&gt;<span style="font-family:arial,sans-serif;font-size:13px">If we go for the accept header and the consumer don&#39;t provide it, what do we do ? Return an error or use implicitly the latest version ?</span></div>
<div>
<span style="font-family:arial,sans-serif;font-size:13px">Perhaps we can return the current version to not break any existing clients. New clients will need to provide an explicit version.</span></div></div></blockquote>
<div>Why not but for how long do we return the &quot;old&quot; version by default ? (cf my questions around deprecation)  </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="HOEnZb"><div class="h5"><div class="gmail_extra">
<br><br><div class="gmail_quote">On 28 August 2014 09:25, Sebastien Blanc <span dir="ltr">&lt;<a href="mailto:scm.blanc@gmail.com" target="_blank">scm.blanc@gmail.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div dir="ltr">Some questions : <div><br></div><div>* If we go for the accept header and the consumer don&#39;t provide it, what do we do ? Return an error or use implicitly the latest version ?</div><div>* What will be our deprecation policy ? Do we want keep maintaining all the versions forever or let&#39;s say for 1.1 we still provide 1.0 and for 2.0 we drop 1.0 ? </div>


<div><br></div><div>About the implementation :</div><div>* I like the suggested CDI solution, if possible.</div><div>* Erik also mentionned OSGI and I&#39;m -9999^99 to introduce that techno </div><div><br></div><div>Sebi</div>


<div>ps : I just read this blog post and it&#39;s really interesting : <a href="http://apiux.com/2013/05/14/api-versioning/" target="_blank">http://apiux.com/2013/05/14/api-versioning/</a></div><div><br></div></div><div>

<div><div class="gmail_extra">
<br><br><div class="gmail_quote">On Thu, Aug 28, 2014 at 8:07 AM, Daniel Bevenius <span dir="ltr">&lt;<a href="mailto:daniel.bevenius@gmail.com" target="_blank">daniel.bevenius@gmail.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<div dir="ltr">+1 For using the Accept header to specify the version in the media type.</div><div class="gmail_extra"><br><br><div class="gmail_quote"><div><div>On 28 August 2014 07:50, Matthias Wessendorf <span dir="ltr">&lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;</span> wrote:<br>



</div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div><div dir="ltr"><div>Hello,</div><div><br></div><div>for the 1.1.x (master) we are potentially doing some changes on the Sender-API (see [1]).</div>



<div><br></div><div>However, for backwards compatibility we need to think about API versioning.</div>
<div><br></div><div>For REST APIs there are (IMO) two options:</div><div>* accept header</div><div>* URIs</div><div><br></div><div>On our Face2Face meeting we briefly talked about this and I think the &quot;accept header&quot; solution was the one that had most fans. I think QMX added that it is better for migration. One thing we were not clear on (I think): What are HATEOS defined semantics?</div>




<div><br></div><div><br></div><div>Besides the what (headers vs. URI), I think we should think about possible implementations, to switch different versions.</div><div><br></div><div>Not sure, but wouldn&#39;t it be possible to inject an annotated SenderService into the RESTful endpoint, based on header values ? </div>




<div>We could have a default impl (version 1.0.0) and an alternate one, that is injected if the accept header indicate API version 1.1</div><div><br></div><div>Any thoughts ? </div><div><br></div><div>-Matthias</div><div>




<br></div><div><br></div><div>[1] <a href="http://lists.jboss.org/pipermail/aerogear-dev/2014-August/008881.html" target="_blank">http://lists.jboss.org/pipermail/aerogear-dev/2014-August/008881.html</a><span><font color="#888888"><br>



</font></span></div><span><font color="#888888"><div><br></div>-- <br>Matthias Wessendorf <br>
<br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>




twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a>
</font></span></div>
<br></div></div>_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br></blockquote></div><br></div>
<br>_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br></blockquote></div><br></div>
</div></div><br>_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br></blockquote></div><br></div>
</div></div><br>_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br></blockquote></div><br></div></div>