<html>
  <head>
    <meta content="text/html; charset=windows-1252"
      http-equiv="Content-Type">
  </head>
  <body text="#000000" bgcolor="#FFFFFF">
    Hi Aline,<br>
    <br>
    Versioning helps you iterate faster and prevents invalid requests
    from hitting updated endpoints. It also helps smooth transitions
    over any major API version as you can continue to offer old API
    versions for a period of time. Definitely supporting the old version
    of API period of time while offering new functionality with newer
    version always give benefits and extra time for end user to adjust
    to new one.<br>
    <br>
    I see lot of products in the market are adapting versioning (see
    below link)<br>
<a class="moz-txt-link-freetext" href="http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/">http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/</a><br>
    <br>
    I do understand the concern of maintaining the version of the API
    endpoints , below are some of the links from Openstack, which talks
    about it.<br>
    <a class="moz-txt-link-freetext" href="http://developer.openstack.org/api-ref.html">http://developer.openstack.org/api-ref.html</a><br>
    <a class="moz-txt-link-freetext" href="https://wiki.openstack.org/wiki/VersionDiscovery">https://wiki.openstack.org/wiki/VersionDiscovery</a><br>
    <br>
    Hope it make senses to you.<br>
    <br>
    Regards<br>
    Chandra<br>
    <br>
    <div class="moz-cite-prefix">On 08/06/2015 12:04 AM, Aline Manera
      wrote:<br>
    </div>
    <blockquote cite="mid:55C25745.1000903@linux.vnet.ibm.com"
      type="cite">
      <meta content="text/html; charset=windows-1252"
        http-equiv="Content-Type">
      <br>
      Hi Chandra,<br>
      <br>
      I don't see any benefit in adding the version in the URL. Instead
      of that, it scares me on how we will maintain it.<br>
      <br>
      Once we move to wok and Kimchi as plugin, all the APIs will be
      automatically updated so everything will be in the same page.<br>
      <br>
      Regards,<br>
      Aline Manera<br>
      <br>
      <div class="moz-cite-prefix">On 17/07/2015 09:47, Chandra Sr
        Potula wrote:<br>
      </div>
      <blockquote
cite="mid:OF5F31939B.F65133B3-ON65257E85.0044037D-65257E85.0046405F@in.ibm.com"
        type="cite">
        <p><font face="DejaVu Serif" size="2">Hi Kimchi/Ginger
            Devel-Team,</font><br>
          <br>
          <font face="DejaVu Serif" size="2">Thank you for creating WOK
            branch to separate the kimchi plugin from the base frame
            work. It is a great idea.</font><br>
          <br>
          <font face="DejaVu Serif" size="2">Along with the separation
            of kimchi plugin looks like there is a transformation of
            REST API URIs as well. So thinking in those lines will it be
            good idea even to introduce version to the REST API URIs ?</font><br>
          <br>
          <font face="DejaVu Serif" size="2">Let me take one REST API
            URI to convey clear on what I am talking about.</font><br>
          <br>
          <font face="DejaVu Serif" size="2">To retrieve the host
            repository information, current URI is:
             "/plugins/kimchi/host/repositories".</font><br>
          <br>
          <font face="DejaVu Serif" size="2"><b>Recommendation</b></font><font
            face="DejaVu Serif" size="2">:</font><br>
          <font face="DejaVu Serif" size="2">New host repository URI can
            look like : </font><font face="DejaVu Serif" size="2"><b>"</b></font><font
            face="DejaVu Serif" size="2"><b>/plugins/kimchi/v&lt;version&gt;/host/repositories"

              , </b></font><font face="DejaVu Serif" size="2">so that
            it is easy to maintain REST API future enhancements at the
            same time do not brake some body who is using the existing
            URI.</font><br>
          <br>
          <font face="DejaVu Serif" size="2">Note* Adding version in the
             URI above is just an example and we could place the version
            in the URI best possible way.</font><br>
        </p>
        <p><font face="DejaVu Serif" size="2">Thanks and Regards,</font><br>
          <font face="Georgia" size="3" color="#888888"><b>Chandra
              Shekhar Reddy Potula</b></font><font face="Georgia"
            size="1" color="#00CCFF"><br>
            Staff System Software Engineer<br>
            IBM Systems &amp; Technology Group, Systems Software
            Development<br>
            System z Firmware Development</font><font face="serif"
            size="3"> </font>
          <table border="0" cellpadding="0" cellspacing="0">
            <tbody>
              <tr valign="top">
                <td colspan="2" valign="middle" width="650">
                  <hr align="left" size="2" width="100%"></td>
              </tr>
              <tr valign="top">
                <td width="401"><font face="Georgia" size="1"
                    color="#466BB0"><b>Phone:</b></font><font
                    face="Georgia" size="1" color="#5F5F5F"> 91-080-4066-0786</font><font
                    face="Georgia" size="1" color="#466BB0"> | </font><font
                    face="Georgia" size="1" color="#466BB0"><b>Mobile:</b></font><font
                    face="Georgia" size="1" color="#5F5F5F"> 91-973-1122-221</font><font
                    face="Georgia" size="1" color="#466BB0"><b><br>
                      E-mail:</b></font><font face="Georgia" size="1"
                    color="#5F5F5F"> </font><a moz-do-not-send="true"
                    href="mailto:chandra.shekhar@in.ibm.com"
                    target="_blank"><font face="Georgia" size="1"
                      color="#5F5F5F"><u>chandra.shekhar@in.ibm.com</u></font></a></td>
                <td width="249">
                  <div align="right"><img
                      src="cid:part2.00000602.00090101@linux.vnet.ibm.com"
                      alt="IBM" height="30" width="83"><font
                      face="Georgia" size="1" color="#5F5F5F"><br>
                      <br>
                      ORR, Manyatha MD3 1F B247<br>
                      Bengaluru, Karnataka 560045<br>
                      India</font></div>
                </td>
              </tr>
            </tbody>
          </table>
          <font face="serif" size="3"> </font> <br>
        </p>
        <fieldset class="mimeAttachmentHeader"></fieldset>
        <br>
        <pre wrap="">_______________________________________________
Kimchi-devel mailing list
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:Kimchi-devel@ovirt.org">Kimchi-devel@ovirt.org</a>
<a moz-do-not-send="true" class="moz-txt-link-freetext" href="http://lists.ovirt.org/mailman/listinfo/kimchi-devel">http://lists.ovirt.org/mailman/listinfo/kimchi-devel</a>
</pre>
      </blockquote>
      <br>
      <br>
      <fieldset class="mimeAttachmentHeader"></fieldset>
      <br>
      <pre wrap="">_______________________________________________
Kimchi-devel mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Kimchi-devel@ovirt.org">Kimchi-devel@ovirt.org</a>
<a class="moz-txt-link-freetext" href="http://lists.ovirt.org/mailman/listinfo/kimchi-devel">http://lists.ovirt.org/mailman/listinfo/kimchi-devel</a>
</pre>
    </blockquote>
    <br>
  </body>
</html>