How are REST APIs versioned?

矫情吗；* 2022-08-05 02:43 156阅读 0赞

# How are REST APIs versioned? #

Posted on  [March 12, 2012][March 12_ 2012], Modified on September 15, 2014

I am currently working on a REST API, and the question was raised, how are, and how should, REST APIs be versioned? Here are the results of my research.

It seems that there are a number of people recommending using Content-Negotiation (the HTTP “Accept:” header) for API versioning. However, none of the big public REST APIs I have looked at seem to be using this approach. They almost exclusively put the API version number in the URI, with the odd exception using a custom HTTP header. I am at somewhat of a loss to explain this disconnect.

## Versioning strategies in discussions ##

## Versioning strategies in popular REST APIs ##

<table style="border-width:0px 0px 1px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; font-weight:inherit; margin:0px 0px 1.625em; outline:0px; padding:0px; vertical-align:baseline; border-spacing:0px; width:779px"> 
 <tbody style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <th style="border:0px; font-family:inherit; font-size:10px; font-style:inherit; font-weight:500; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(102,102,102); letter-spacing:0.1em; line-height:2.6em; text-transform:uppercase"> API NAME</th> 
   <th style="border:0px; font-family:inherit; font-size:10px; font-style:inherit; font-weight:500; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(102,102,102); letter-spacing:0.1em; line-height:2.6em; text-transform:uppercase"> VERSIONING</th> 
   <th style="border:0px; font-family:inherit; font-size:10px; font-style:inherit; font-weight:500; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(102,102,102); letter-spacing:0.1em; line-height:2.6em; text-transform:uppercase"> EXAMPLE</th> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Twillo API" href="http://www.twilio.com/docs/api/rest/making-calls" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Twillo</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> date in URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="twitter api versioning" href="https://groups.google.com/forum/?fromgroups#!topic/twitter-api-announce/K3C9bqSuwXU" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Twitter</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Atlassian API versioning" href="https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Atlassian</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="google search api" href="http://code.google.com/apis/customsearch/v1/using_rest.html" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Google Search</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="github api versioning" href="http://develop.github.com/p/general.html" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Github API</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI/Media Type in v3</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="github versioning future" href="http://developer.github.com/v3/media/#api-v3-media-type-and-the-future" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Intention is to remove versioning in favour of hypermedia</a>&nbsp;– current application/vnd.github.v3</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Azure" href="http://msdn.microsoft.com/en-us/library/windowsazure/dd894041.aspx" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Azure</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> Custom Header</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> x-ms-version: 2011-08-18</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a href="https://developers.facebook.com/docs/apps/versions" title="facebook versioning policy" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Facebook</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI/optional versioning</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> graph.facebook.com/v1.0/me</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="bing maps api versioning" href="http://msdn.microsoft.com/en-us/library/ff701714.aspx" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Bing Maps</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="google maps" href="http://code.google.com/apis/maps/documentation/staticmaps/upgrade.html" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Google maps</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> unknown/strange</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="netflix api versioning" href="http://developer.netflix.com/docs/REST_API_Conventions#0_pgfId-1009147" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Netflix</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI parameter</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://api.netflix.com/catalog/titles/series/70023522?v=1.5</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="salesforce api versioning" href="http://www.salesforce.com/us/developer/docs/api/index.htm" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Salesforce</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI with version introspection</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> { <br> “label”:”Winter ’10”<br> “version”:”20.0″,<br> “url”:”/services/data/v20.0″,<br> }</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="google data api versioning" href="http://code.google.com/apis/gdata/docs/developers-guide.html" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Google data API (youtube/spreadsheets/others)</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI parameter or custom header</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> “GData-Version: X.0″ or “v=X.0″</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> Flickr</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> No versioning?</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Digg API versioning" href="http://apidoc.digg.com/w/page/17759000/FrontPage" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Digg</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://services.digg.com/2.0/comment.bury</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="delicious API versioning" href="http://delicious.com/developers" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Delicious</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://api.del.icio.us/v1/posts/update</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="lastFM api versioning" href="http://www.last.fm/api/intro" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Last FM</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://ws.audioscrobbler.com/2.0/</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> LinkedIn</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://api.linkedin.com/v1/people/~/connections</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="foursquare API versioning" href="https://developer.foursquare.com/docs/" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Foursquare</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://api.foursquare.com/v2/venues/40a55d80f964a52020f31ee3?oauth_token=XXX&amp;v=YYYYMMDD</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="freebase api versioning" href="http://wiki.freebase.com/wiki/ApiSearch" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Freebase</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://www.googleapis.com/freebase/v1/search?query=nirvana&amp;indent=true</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="paypal versioning" href="https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&amp;content_ID=developer/e_howto_api_nvp_NVPAPIOverview" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">paypal</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> parameter</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &amp;VERSION=XX.0</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="twitpic" href="http://dev.twitpic.com/docs/2" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Twitpic</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://api.twitpic.com/2/upload.format</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Etsy API versioning" href="http://www.etsy.com/developers/documentation/getting_started/api_basics" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Etsy</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://openapi.etsy.com/v2</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Tropo API versioning" href="https://www.tropo.com/docs/rest/starting_session.htm" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Tropo</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://api.tropo.com/1.0/sessions</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Tumblr" href="http://www.tumblr.com/docs/en/api/v2" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Tumblr</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> api.tumblr.com/v2/user/</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="openstreetmap API versioning" href="http://wiki.openstreetmap.org/wiki/API_v0.6" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">openstreetmap</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI and response body</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://server/api/0.6/changeset/create</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Ebay API versioning" href="http://developer.ebay.com/Devzone/shopping/docs/Concepts/ShoppingAPIGuide.html" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Ebay</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI (I think)</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://open.api.ebay.com/shopping?version=713</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Reddit API versioning" href="https://github.com/reddit/reddit/wiki/API" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Reddit</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> No versioning?</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Groupon API versioning" href="http://sites.google.com/site/grouponapiv2/api-resources/channels/deals" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Groupon</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> http://api.groupon.com/v2/channels//deals{.json|.xml}</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="geonames API versioning" href="http://www.geonames.org/export/" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Geonames</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="wikipedia" href="http://www.mediawiki.org/wiki/API" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Wikipedia</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> no versioning I think?</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &nbsp;</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="bitly API versioning" href="http://code.google.com/p/bitly-api/wiki/ApiDocumentation" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Bitly</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://api-ssl.bitly.com/v3/shorten</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="disqus API versioning" href="http://disqus.com/api/docs/posts/remove/" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Disqus</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://disqus.com/api/3.0/posts/remove.json</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="yammer API versioning" href="https://developer.yammer.com/api/#introduction" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Yammer</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> /api/v1</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="dropbox API versioning" href="https://api.dropbox.com/1/oauth/request_token" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Drop Box</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://api.dropbox.com/1/oauth/request_token</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Amazon Simple Queue Service API versioning" href="http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Welcome.html?r=7475" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Amazon Simple Queue Service (Soap)</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI Parameter and WSDL URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> &amp;Version=2011-10-01</td> 
  </tr> 
  <tr style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline"> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> <a title="Youtube data API versioning" href="https://developers.google.com/youtube/v3/docs/" style="border:0px; font-family:inherit; font-style:inherit; font-weight:inherit; margin:0px; outline:0px; padding:0px; vertical-align:baseline; color:rgb(25,130,209); text-decoration:none" rel="nofollow">Youtube data API versioning</a></td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> URI</td> 
   <td style="border-width:1px 0px 0px; border-top-style:solid; border-top-color:rgb(221,221,221); font-family:inherit; font-size:15px; font-style:inherit; margin:0px; outline:0px; padding:6px 10px 6px 0px; vertical-align:baseline"> https://www.googleapis.com/youtube/v3</td> 
  </tr> 
 </tbody> 
</table>

## Versioning strategies in popular REST Libraries ##

### SHARE THIS: ###

*  [Share on Facebook][]
 *  [Click to share on Google+][Click to share on Google]
 *  [Click to share on Twitter][]
 *  [Click to print][]
 *  [More][]
 *

No related posts.

This entry was posted in  [Uncategorized][] by  [Tim Wood][]. Bookmark the  [permalink][March 12_ 2012].

## 23 THOUGHTS ON “HOW ARE REST APIS VERSIONED?” ##

1.  Larry on  [April 16, 2012 at 7:50 pm][April 16_ 2012 at 7_50 pm]  said:
    
    The version of GitHub's API that you link to is deprecated. The new version v3 does its versioning via content negotiation whereas the old one had it in the URI. The new approach is documented here: [http://developer.github.com/v3/mime/][http_developer.github.com_v3_mime]
    
    BTW, I found this very useful. Thanks!
    
    [Reply ↓][Reply]
2.  Pingback: [How are REST APIs versioned? | Lexical Scope | nodeJS and Web APIs | Scoop.it][How are REST APIs versioned_ _ Lexical Scope _ nodeJS and Web APIs _ Scoop.it]
3.  Pingback: [How are REST APIs versioned? | Lexical Scope | Modern web development | Scoop.it][How are REST APIs versioned_ _ Lexical Scope _ Modern web development _ Scoop.it]
4.  Pingback: [How are REST APIs versioned?][How are REST APIs versioned]
5.  [John (@strife25)][John _strife25] on  [November 15, 2012 at 2:57 pm][November 15_ 2012 at 2_57 pm]  said:
    
    Great list! I’ve also found the following article to be useful for API versioning strategies: [http://blog.apigee.com/detail/restful\_api\_design\_tips\_for\_versioning/][http_blog.apigee.com_detail_restful_api_design_tips_for_versioning]
    
    [Reply ↓][Reply 1]
6.  Pingback: [REST Fundamentals | planetgeek.ch][REST Fundamentals _ planetgeek.ch]
7.  [Mizuki Oshiro][] on  [November 27, 2012 at 12:53 pm][November 27_ 2012 at 12_53 pm]  said:
    
    This is usually due to header-mangling and stripping. Mobile ISPs, proxy servers, some regular ISPs – they actually strip out headers from HTTP requests. So while content negotiation is a principally sound and proper way to do it, the realities of the world we live in require putting the version in the URI.
    
    [Reply ↓][Reply 2]
    
     *  Tim Woodon  [November 29, 2012 at 12:41 pm][November 29_ 2012 at 12_41 pm]  said:
        
        Do you think it also has anything to do with people wanting to browse REST services in an ordinary web browser? I wondered if the difficultly of configuring the content-negotiation in most web-browsers might contribute to this.
        
        [Reply ↓][Reply 3]
        
         *  [Ionuț Tiberiu Stan][Ionu_ Tiberiu Stan]on  [May 17, 2013 at 1:22 pm][May 17_ 2013 at 1_22 pm]  said:
            
            Think about API requests from JS (end user browser).
            
            [Reply ↓][Reply 4]
            
             *  Tim Woodon  [May 17, 2013 at 1:49 pm][May 17_ 2013 at 1_49 pm]  said:
                
                I’m not sure I follow you. Are you saying it is easier to do it one way or the other from JS?
                
                [Reply ↓][Reply 5]
8.  Pingback: [Revealing KijiREST: Resources | Kiji Community - Build Real-Time Scalable Data Applications on Apache HBase][Revealing KijiREST_ Resources _ Kiji Community - Build Real-Time Scalable Data Applications on Apache HBase]
9.  abhishek on  [June 12, 2013 at 6:52 am][June 12_ 2013 at 6_52 am]  said:
    
    another reason why URI based versioning isnt right…
    
    [http://bit.ly/14Vr4jc][http_bit.ly_14Vr4jc]
    
    [http://abhishek.pamecha.me/blogs/versioning-in-web-services/][http_abhishek.pamecha.me_blogs_versioning-in-web-services]
    
    [Reply ↓][Reply 6]
10. [David Roncancio][] on  [June 21, 2013 at 5:13 pm][June 21_ 2013 at 5_13 pm]  said:
    
    I think another reason is an implementation reason, because its easier and cleaner to have some web server work as a proxy to take /v1/ -> v1 service implementation instead of handling it in the service itself with a buch of ifs, like if(version==1) -> v1 of the service implementation
    
    [Reply ↓][Reply 7]
11. Pingback: [REST Fundamentals | bbv Blog][REST Fundamentals _ bbv Blog]
12. Owen Rubel on  [March 13, 2014 at 2:11 am][March 13_ 2014 at 2_11 am]  said:
    
    Dont get bogged down by purists. Do what is simple, scalable and practical. Just because it may not fit a spec doesn’t mean it’s not better for your needs or your clients needs. After all, the biggest API users are using URI after all and they serve MILLIONs a day
    
    [Reply ↓][Reply 8]
13. [Ricardo Ruiz López][Ricardo Ruiz L_pez] on  [March 17, 2014 at 12:36 pm][March 17_ 2014 at 12_36 pm]  said:
    
    Hello!  
    When an API is obsoleted, what do you do normally when you want to block an older version? What mechanism do you use?  
    Thanks.
    
    [Reply ↓][Reply 9]
    
     *  Fred Flintstoneon  [August 2, 2014 at 2:44 am][August 2_ 2014 at 2_44 am]  said:
        
        you are talking about deprecation and you need to version both the api form and the api function; in other words, you need to do versioning on the api application as well as on the apiObject that establishes how the api request/response is handled for each related uri.
        
        [Reply ↓][Reply 10]
14. Pingback: [Decoupling API Versions From Codebase Versions | Haddad's Journal][Decoupling API Versions From Codebase Versions _ Haddad_s Journal]
15. Owen Rubel on  [June 25, 2014 at 3:30 am][June 25_ 2014 at 3_30 am]  said:
    
    Found out after much reading that there is a good reason not to do versioning in header. forwards will not send header information properly and so it will often get lost. This is why alot of people after evaluation have stayed with versioning in the URI
    
    [Reply ↓][Reply 11]
    
     *  BeosFreakon  [May 15, 2015 at 1:24 pm][May 15_ 2015 at 1_24 pm]  said:
        
        If that is the case then the forward is not being performed correctly. You would lose authorization, language, media types, etc.. Version belongs in the accept header. i.e. I accept this media type and this version.
        
        [Reply ↓][Reply 12]
16. Pingback: [El mekki anouar | API Versioning – Different Approaches to API Versioning (1)][El mekki anouar _ API Versioning _ Different Approaches to API Versioning _1]
17. Pingback: [RESTful APIs | LibreNMS development blog][RESTful APIs _ LibreNMS development blog]
18. Pingback: [Designer une API REST | OCTO talks !][Designer une API REST _ OCTO talks]

### Leave a Reply ###

[March 12_ 2012]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/
[Share on Facebook]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?share=facebook&nb=1
[Click to share on Google]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?share=google-plus-1&nb=1
[Click to share on Twitter]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?share=twitter&nb=1
[Click to print]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#print
[More]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#
[Uncategorized]: http://www.lexicalscope.com/blog/category/uncategorized/
[Tim Wood]: http://www.lexicalscope.com/blog/author/lexicalscope/
[April 16_ 2012 at 7_50 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-437
[http_developer.github.com_v3_mime]: http://developer.github.com/v3/mime/
[Reply]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=437#respond
[How are REST APIs versioned_ _ Lexical Scope _ nodeJS and Web APIs _ Scoop.it]: http://www.scoop.it/t/4-nodejs/p/2801734208/how-are-rest-apis-versioned-lexical-scope
[How are REST APIs versioned_ _ Lexical Scope _ Modern web development _ Scoop.it]: http://www.scoop.it/t/modern-web-development/p/2809182158/how-are-rest-apis-versioned-lexical-scope
[How are REST APIs versioned]: http://matthew.delmarters.com/weblog/how-are-rest-apis-versioned/
[John _strife25]: http://twitter.com/strife25
[November 15_ 2012 at 2_57 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2422
[http_blog.apigee.com_detail_restful_api_design_tips_for_versioning]: http://blog.apigee.com/detail/restful_api_design_tips_for_versioning/
[Reply 1]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2422#respond
[REST Fundamentals _ planetgeek.ch]: http://www.planetgeek.ch/2012/11/27/rest-fundamentals/
[Mizuki Oshiro]: http://www.facebook.com/mizuki.oshiro1
[November 27_ 2012 at 12_53 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2426
[Reply 2]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2426#respond
[November 29_ 2012 at 12_41 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2427
[Reply 3]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2427#respond
[Ionu_ Tiberiu Stan]: http://www.facebook.com/tiberiu.ionut.stan
[May 17_ 2013 at 1_22 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2435
[Reply 4]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2435#respond
[May 17_ 2013 at 1_49 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2436
[Reply 5]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2436#respond
[Revealing KijiREST_ Resources _ Kiji Community - Build Real-Time Scalable Data Applications on Apache HBase]: http://www.kiji.org/2013/05/20/revealing-kijirest-resources/
[June 12_ 2013 at 6_52 am]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2438
[http_bit.ly_14Vr4jc]: http://bit.ly/14Vr4jc
[http_abhishek.pamecha.me_blogs_versioning-in-web-services]: http://abhishek.pamecha.me/blogs/versioning-in-web-services/
[Reply 6]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2438#respond
[David Roncancio]: http://twitter.com/kuryaki
[June 21_ 2013 at 5_13 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2439
[Reply 7]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2439#respond
[REST Fundamentals _ bbv Blog]: http://blog.bbv.ch/2012/11/27/rest-fundamentals/
[March 13_ 2014 at 2_11 am]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2445
[Reply 8]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2445#respond
[Ricardo Ruiz L_pez]: https://www.facebook.com/ricardo.ruiz.lopez
[March 17_ 2014 at 12_36 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2446
[Reply 9]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2446#respond
[August 2_ 2014 at 2_44 am]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2838
[Reply 10]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2838#respond
[Decoupling API Versions From Codebase Versions _ Haddad_s Journal]: http://my-jour.nl/2014/04/10/decoupling-api-versions-from-codebase-versions/
[June 25_ 2014 at 3_30 am]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-2632
[Reply 11]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=2632#respond
[May 15_ 2015 at 1_24 pm]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/#comment-4496
[Reply 12]: http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/?replytocom=4496#respond
[El mekki anouar _ API Versioning _ Different Approaches to API Versioning _1]: http://elmekkianouar.com/?p=40
[RESTful APIs _ LibreNMS development blog]: http://blog.librenms.org/2014/09/restful-apis/
[Designer une API REST _ OCTO talks]: http://blog.octo.com/designer-une-api-rest/