Realm Status API documentation?

#1 - April 20, 2011, 8:41 p.m.

I was wondering if there was going to be any documentation provided for the realms status api (and others as they are released). What I mean by that is I am interested in the definitions and scope of the data that is going to be provided.

For example if one directs a browser to:

http://us.battle.net/api/wow/realm/status?realm=Bloodhoof

they would get back json data that looks like:

{
  "realms":[
    {
      "type":"pve",
      "population":"high",
      "queue":false,
      "status":true,
      "name":"Bloodhoof",
      "slug":"bloodhoof"
    }
  ]
}

What are the possibilities for each entry?
i.e
type could be pve, pvp, rp, etc?
population could be full, high, medium, low, empty, etc?
status could be true, false, locked, etc?

Thanks,

Darque
<Elder Tribunal> on Bloodhoof

Straton

Web & Mobile Team

#5 - May 25, 2011, 3:19 p.m.

Hm. Uther is down for a rolling restart right now, but the API is returning a status of true. Bug with the API, or bug with detecting whether a realm is up?

There are several tiers of caching that the realm status data goes through by the time it is delivered to API consumers. We've made to note to track this and make sure that the delay in a realm's status and what the status is reported as is reasonable.