wow Community Platform API 簡單介紹 - WOW

Community Platform API是用來獲得一些儲存在官方網站中的資料。
這個API目前仍在演進，因此本文內容可能因時間而改變。
官方論壇：http://us.battle.net/wow/en/forum/2626217/
文件：http://blizzard.github.com/api-wow-docs/

1.----------------------------------------------------------------------------
好像很難？不會。
直接來個範例：http://tw.battle.net/api/wow/character/shadowmoon/tyurru
(用firefox + firefox addon: JSONView 0.7 可以直接看，
或者用記事本打開剛剛下載的檔案。)

{
"lastModified": 1320684594000,
"name": "Tyurru",
"realm": "暗影之月",
"class": 5,
"race": 5,
"gender": 1,
"level": 85,
"achievementPoints": 12890, ←死宅＿
"thumbnail": "shadowmoon/85/6485-avatar.jpg"
}

正常來說，應該是出現這些東西。各欄位項目，這邊稍微解說：
lastModified: Unix Timestamp，以微秒計算。
轉換網頁 http://www.epochconverter.com/
thumbnail: 大頭圖像，路徑如下↓
http://tw.battle.net/static-render/tw/shadowmoon/85/6485-avatar.jpg

附註：
http://tw.battle.net/static-render/tw/shadowmoon/85/6485-profilemain.jpg
http://tw.battle.net/static-render/tw/shadowmoon/85/6485-inset.jpg
http://tw.battle.net/static-render/tw/shadowmoon/85/6485-card.jpg
恩，你懂的。

2.----------------------------------------------------------------------------
才這樣？當然不是。角色資料的通用格式為：
http://[].battle.net/api/wow/character/[]/[]?fields=[,]
↑ ↑ ↑ ↑
區域，tw/us.... 伺服器名稱 角色名稱 欄位

欄位裡面可以填：
guild stats talents items
reputation titles professions appearance
companions mounts pets achievements
progression pvp quests

例如：
http://tw.battle.net/api/wow/character/shadowmoon/tyurru?fields=pvp,guild
這邊就不一一示範了。

附註：guild欄位中的Color，是用後6個英數字來當作顏色。
例如上面的網址，"ff003582"要取"003582"。
此為hex color，可在 http://www.colorschemer.com/online.html 上填入，
看到顏色。

3.----------------------------------------------------------------------------
能看其他東西嗎？
好吧，先來看競技場好了。
http://us.battle.net/api/wow/pvp/arena/Bloodlust/5v5 (注意，是美國，台版無)

可是，上面只有50個隊伍耶？
http://us.battle.net/api/wow/pvp/arena/Bloodlust/5v5?size=500 恩，前500強。

看特定隊伍：
http://us.battle.net/api/wow/arena/Tichondrius/2v2/nodksplzkthxbai
↑ ↑ ↑ ↑
區域，tw/us.... 伺服器名稱 22/33/55 隊伍名稱


4.----------------------------------------------------------------------------
來看公會：
http://[].battle.net/api/wow/guild/[]/[]?fields=[,]
↑ ↑ ↑ ↑
區域，tw/us.... 伺服器名稱 公會名稱 欄位

欄位裡面可以填：achievements, members


5.----------------------------------------------------------------------------
這些都沒啥阿……
好吧，來點刺激的。
http://us.battle.net/api/wow/auction/data/shadowmoon (注意，是美國，台版無)

{
"files": [
{
"url": "http://us.battle.net/auction-data/shadowmoon/auctions.json",
"lastModified": 1320749922000
}
]
}
正常來說，應該是出現這些東西。當然，那個url就是該伺服器上
部落、中立和聯盟拍賣場內的資料。

範例網站：http://www.ahspy.com
http://www.ahspy.com/us/shadowmoon/item/2770/copper-ore
嗯...


6.----------------------------------------------------------------------------
好了，簡單的介紹，大概就這樣。下面給一些網址，有興趣的可以點進去看。
http://us.battle.net/api/wow/realm/status
http://us.battle.net/api/wow/data/character/achievements
http://us.battle.net/api/wow/data/character/classes
http://us.battle.net/api/wow/data/character/races
http://us.battle.net/api/wow/data/item/classes
http://us.battle.net/api/wow/data/guild/perks
http://us.battle.net/api/wow/data/guild/rewards
http://us.battle.net/api/wow/data/guild/achievements
http://us.battle.net/api/wow/data/battlegroups/
http://us.battle.net/api/wow/quest/25
http://us.battle.net/api/wow/item/25

--
BIG BROTHER IS WATCHING YOU

—— George Orwell, Nineteen Eighty-Four

--