25

I decided to Google for the StackExchange API. The first link on Google is:

http://api.stackoverflow.com

This itself transforms into:

http://api.stackoverflow.com/1.0/usage

This has a big notice at the top saying "The V1.x family of APIs is obsolete, having been replaced by the V2.x family", which in turn links to:

http://blog.stackoverflow.com/2012/02/stack-exchange-api-v2-0-no-longer-beta

...which finally links to:

https://api.stackexchange.com

Hoorah!


Can http://api.stackoverflow.com instead redirect directly to the V2.0 API?

A link can then be added to the V2.0 API site to point back to the V1.x documentation for anyone still needing to access that.

14
  • 1
    Yeah.. I got really confused as well.
    – ɥʇǝS
    Commented May 21, 2013 at 17:48
  • 9
    So for v2 we added security?
    – djechlin
    Commented May 21, 2013 at 17:49
  • 5
    @djechlin security by redirection! It's like a giant shell game! Which one is the API under? I don't know! Commented May 21, 2013 at 18:22
  • If we redirected automatically we'd break any v1 clients. Not that I'm disagreeing it should be easier to navigate to, it most certainly should since we'd like to get everyone off v1. Commented May 21, 2013 at 20:27
  • @NickCraver as someone who hasn't used the API (yet), what is the reason redirecting just that page would break V1 clients? Commented May 21, 2013 at 21:18
  • @Nick: ... even if you just redirect the homepage, rather than the whole domain?
    – Matt
    Commented May 22, 2013 at 8:27
  • @Matt then how would you find any documentation on V1? It should be a header and one link away IMO. Commented May 22, 2013 at 10:30
  • 1
    @NickCraver I think you've misunderstood my redirection request. The only part that would need to be redirected is the base URL (http://api.stackoverflow.com). The documentation would still exist at http://api.stackoverflow.com/1.0/usage. Commented May 22, 2013 at 10:31
  • @James, and they'd find that URL....how? We do still support it, even if we'd like people to move to v2. Commented May 22, 2013 at 10:35
  • @NickCraver: By adding a link to the v1 documentation on api.stackexchange.com ? If both http and https go to (what is now) api.stackexchange.com, a link to the v1 documentation on that page lets everyone access the API they're after, without any jumping through hoops and redirects. I'm not against a header & one jump link, #justsaying I don't see the issue of redirecting the homepage.
    – Matt
    Commented May 22, 2013 at 10:35
  • 1
    @Matt the API documentation links and testing for v1 is per site, you can't link to any one place from there, stackoverflow is one of nearly 200 sites with an API v1 endpoint. Commented May 22, 2013 at 10:37
  • @NickCraver: Ahhhhhhhhhhhhhhhh. I've been missing v1 was on each sites domain, rather than SE.com ;). Nowwwww I understand :P.
    – Matt
    Commented May 22, 2013 at 10:39
  • @NickCraver ^ "A link can then be added to the V2.0 API site to point back to the V1.x documentation for anyone still needing to access that." Something like i.imgur.com/VOaSyam.png Edit: Oh, I see. Commented May 22, 2013 at 10:40
  • 1
    @Matt yup, which is why it won't be included in the SSL move, it's another ~200 domains. Commented May 22, 2013 at 10:42

1 Answer 1

2

In a comment by Nick Craver, he explains why http://api.stackoverflow.com can't redirect directly to https://api.stackexchange.com/:

If we redirected automatically we'd break any v1 clients. Not that I'm disagreeing it should be easier to navigate to, it most certainly should since we'd like to get everyone off v1. – Nick Craver♦

Therefore, I think the link on http://api.stackoverflow.com should just redirect to https://api.stackexchange.com/. If I click there, I probably want to go to the v2 api, not go to a blog post about the v2 api.

Also, the link is kind of hard to see since it's only four characters:

image

I think the link should include the text "the V2.x family," so it is easier to notice. Not only does Fitts' Law apply, it is also almost impossible to see when you have visited the link already.

1
  • It's a very bad assumption that someone visiting v1 automatically wants to redirect to v2. People supporting v1 apps, or porting to v2 most certainly wants to see the v1 documentation. We don't want to hide the old documentation, we'd like people to use it to port over. Commented May 22, 2013 at 11:06

You must log in to answer this question.

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