Take the 2-minute tour ×
Stack Apps is a question and answer site for apps, scripts, and development with the Stack Exchange API. It's 100% free, no registration required.

http://api.stackoverflow.com/0.8/help works.
http://api.stackoverflow.com/1.0/help does not.

Is there something that returns 0.8 as the most recent version? And/or is there something that lists every version?

share|improve this question
    
Should probably be rolled into the Discovery API feature request (stackapps.com/questions/30/should-there-be-a-discovery-api) –  Franci Penov May 22 '10 at 4:50
add comment

3 Answers 3

up vote 5 down vote accepted

Currently there is only one version alive at a time (0.8). While in beta, I'm guessing this will be the norm.

Once out of beta, there will probably be an upgrade period for minor versions ("1.1 is released! Update your 1.0 apps!"). However, for major versions there will be two api's running at the same time (1.0 and 2.0).

From the original API announcement:

3. If you build to our API, we will support you. We will be ultra responsive to your feedback during this private beta. And once the API is released, we vow to support version 1.0 of the API for a long time — and if there is a version 2.0, it will be supported in parallel with 1.0 for as long as we can. We’re honored you would write code against our API and we plan to return the favor by not breaking your code a year down the line.

share|improve this answer
add comment

Well /stats indicates (current) API version

{
  "statistics": [
    {
      "total_questions": 39206,
      "total_unanswered": 6161,
      "total_answers": 95349,
      "total_comments": 135925,
      "total_votes": 299689,
      "total_badges": 61312,
      "total_users": 37454,
      "questions_per_minute": 0.08,
      "answers_per_minute": 0.16,
      "badges_per_minute": 0.10,
      "api_version": {
        "version": "0.8",
        "revision": "1.0.1234.5678"
      }
    }
  ]
}
share|improve this answer
4  
/stats is version-specific. you need to know if particular API version exists before calling it. –  Franci Penov May 22 '10 at 4:48
1  
Maybe you could check for a 404 HTTP response to an API URL like "api.stackoverflow.com/1.0/stats"; to make sure it exists before you use it. Otherwise, a feature request to have the base URL "api.xyz.com" return the current version as a header would be good. –  Justin Biard May 22 '10 at 16:18
add comment

First of all, I completely agree with Joel Potter's answer. However, here, I want to respond to the feature-request part of your question.

I think that the Team needs to implement a small feature here on StackApps that was present during the private beta.

I'm referring to a small banner at the top of each page here (the ones that are usually used on Trilogy sites before planned downtimes). This banner should tell us the current status of the API and what version of the API is the newest.

Of course, once we reach multiple API versions (as explained in Joel Potter's answer), we might have this still display the latest version but also link to a page with all versions.

share|improve this answer
1  
This was already requested - stackapps.com/questions/78/official-status-site-page-banner –  Franci Penov May 22 '10 at 4:49
add comment

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .