API Discussion

May 8, 2017 Introducing the Game Data API and Profile API Throm-Ka Community Developers! Over the past year or so our goblin tinkerers and gnomish engineers have been hard at work crafting new armaments for the API war effort. Early feedback from test survivors has been positive, so we're pulling back the curtain on this new matériel: the Game Data and Profile APIs. Profile Data and Game What Now? The Game Data and Profile APIs are part of a larger strategy that makes it easier for Blizzard to share data both internally and externally. In short, it allows Blizzard teams to use a single, well defined interface to publish data into the Game Data and Profile system. Once published, a simple but powerful set of access control mechanisms allow us to share our data however we like. The difference between Game Data and Profile APIs is the type of data they handle. As you might have guessed form the names, the Game Data API stores data related to a game itself (which we call static data) while the Profile API is used to store data related to individuals, their characters, or accounts (which we call dynamic data). Game Data includes generic information like a list of abilities on a character, server status, or even the current leaderboards for a game. On the other hand, Profile data, includes the equipment on a character, an account's achievements, or a list of characters. As a rule of thumb, Profile data is more sensitive than Game Data. In order to access restricted data, you will need to request and receive approval for additional OAuth scopes. What Happened with the Initial Tests? What About the Survivors? Survivors? Oh, the field trials! Nuuh… that's not important. What's important is that the tech they tested was a rousing success! The first major API exposed with our new system was the D3 Leaderboards. These leaderboards aren't just for public consumption -- we're using them to power the leaderboards on our own D3 website. In the past our websites & APIs shared the same pipelines to access data, but through a slightly different set of APIs. With the introduction of this new system, our websites and yours will be consuming the exact same APIs. We'll get the exact same development experience as our community developers, so we're even more incentivized to keep on top of bugs and feature requests. Over the course of 2017 we're planning to continue developing these new APIs. Additionally, we'll begin migrating most of our existing (legacy) APIs over to the Game Data and Profile API system. Not all of our APIs are a perfect match for this system, though, so some endpoints (e.g. /user/account) won't follow the URL patterns covered in the next section. As we progress in our efforts, we'll continue dogfooding our APIs on our own projects and exposing them more broadly once they've been proven out. So have no fear, our tinkerers and engineers have a lot of exciting stuff coming your way! How are Game Data/Profile Different From Existing APIs? Right! Everything we've discussed so far is all well and good, but what does all this mean for you? The two biggest, most immediate differences for the grunts in the trenches are a tweaks to URL & authentication strategy. The legacy APIs use this basic URL pattern: ... Game Data and Profile APIs use slightly different URL pattern: ... Notice that the URLs for APIs exposed using the Game Data and Profile API always begin with data or profile, respectively. They also require access tokens rather than an API key. A few users on our forums have noted that API keys are not private. As such, it's technically possible for one application to make requests for public data using another application's key. Access tokens help tamp down on that by making sure the request actually came from your application. Let's do a quick review of our OAuth 2.0 authentication schemes. Most developers using our APIs are probably familiar with OAuth 2.0's Authorization Code Grant. This lets your app get a token that indicates a user has given the token holder permission to make requests on their behalf. The Client Credentials Grant does the same thing, but for applications; the token holder is given permission to make requests on behalf of your application. While you can use an authorization token to make generic requests, that might end up being more trouble than it's worth. Generally, we recommend applications use client tokens when requesting generic or public data and authorization tokens when requesting user-specific data. That’s as simple as remember to stick your enemies with the pointy end! Anything Else? We've covered a lot, but the team still has several other irons in the fire. We can't wait to share the other projects we've got cooking. No spoilers (since I don't even know what this means) but the other day I think heard someone talking about the the next API for… oh! LFR just popped, gotta run! Hope to see you all at BlizzCon 2016 ;) For the Warchief! -AndanionAndanion35 May 8, 2017
Aug 12, 2014 Intro & Documentation Welcome to the Battle.net API forum! Here you'll find links to documentation and discussions between the developers of the various APIs and the community consuming them. This forum is intended for developers interested in the services provided by Blizzard Entertainment, so be aware that the discussions may be more technical in nature than most other forums. Here's some links to point you in the right direction: Battle.net API Site - https://dev.battle.net/ Guides - https://dev.battle.net/docs Interactive API Reference - https://dev.battle.net/io-docsMagena0 Aug 12, 2014
Sep 3 [Showcase] Post your app! No result about to find a "showcase post" investigation on this forum, so I decided to create this thread. (Maybe i missed the post, hope no). First at all, this forum is dedicated to help users of the Battle.net API to perform and fix their projects for Blizzard games communities. I'm really interested to see what you guys created with the Battle.net API (Guilds feeds, Roster management, etc). Template to use: Name: App name URL: App URL or Download link Platform: Web/Mobile/etc Code: Language used (Java, PHP, etc) Functions: The main purpose of your app UPDATE: My project is no more, so I have nothing to share with you guys: <Gym92 Sep 3
May 13 Battle.net API Terms of Use FAQ (updated 2015/05/11) Throm-Ka Community Developers! You're bound to have some questions about our revised Battle.net API Terms of Use. If you do have a question, please post it in this thread and we'll pass it on to our legal team. As our legal team answers your questions, we'll keep track and build out a solid policy FAQ as a community resource. All answered questions will be summarized in this thread. 1. It seems that the previous "code which uses the API must be open-source" requirement has been removed? Correct, the open source requirement has been removed. 2. Does this mean we are not allowed to use client-side requests (such as with JSONP format), as they require the API Key to be shared with the consuming users? No. As long as your Application Secret remains private you can share the API key with consuming customers when coding requires it - for example, when utilizing OAuth, etc.Andanion20 May 13
Nov 5, 2015 Battle.net API Terms of Use (updated 2015/05/11) Throm-Ka Community Developers! I wanted to bring to your attention that we have updated our Battle.net API Policy and Terms of Use. Please take a moment and review the new Battle.net API Terms of Use, which can be found here: https://dev.battle.net/policy Additionally, if you have policy specific questions you can ask them in this thread. We'll run them past our legal department and try to get you answers as soon as possible. Thank you!Andanion0 Nov 5, 2015
Aug 13 Community Created Libraries & Resources (updated 2017/03/13) A number of our the developers in our community have put together resources, libraries, and other tools that you may find helpful when developing against the Battle.net APIs. API Forums erorus's RSS blue trackers for the API Discussion and Bug Report forums (post) API Tools By Language PHP Ulminia's OAuth library (post, GitHub) DaPimpShied's Sample API Calls (post) jyggen's Battle.net API lib for PHP 5.4+ (post, GitHub) Acoon's WoW Battle.net Armory API (SourceForge) KwarK's Battle.net API library (GitHub) msuBREAKER's Composer package for the Diablo III API (post, GitHub) AJH's PHPBB extension (post, GitHub) Logans' Blizzard API PHP client (post, GitHub, Packagist) Fireblade's PHP API Reader (post, GitHub) Xklusive's Battle.net API package for Laravel 5 (post, Packagist GitHub) Python Shadow's Django OAuth2 lib (post, GitHub) lockwooddev's Python World of Warcraft Community API Wrapper (Bitbucket) Dorwido's World of Warcraft API module (GitHub) Lazerhawk05's Python wrapper for the SC2 API (post, GitHub) Scala Borak's API Client lib (post, GitHub) HntD's D3 Leaderboard (maybe all-Battle.net) API library (post, GitHub) Java Raffy's WarKit lib - for all your WoW data needs (post 1, post 2, GitHub) Dementhius' OAuth 2.0 library for Android (post, GitHub) Arjun's WoW Community API library (post, GitHub) Puntr's Java wrapper for WoW APIs, wow4j (GitHub) JavaScript Billi's guide for using passport-bnet with multiple regions (post) Gewd's AngualrJS wrapper (post, GitHub) skt's Battle.net API wrapper (GitHub, npm, post) uskimptoc's World of Warcraft API wrapper (GitHub) Crowz's auth package for Meteor JS (GitHub, Atmosphere) C# / .Net KetaSwe's contributed a Battle.net module to OwinOAuthProviders (GitHub) Tok's Diablo III API Wrapper (GitHub) bpfz's strongly-typed C# library for Diablo 3 (GitHub) Hellparsley's strongly typed wrapper for the Diablo III API (site) TiaqoY0's (self-proclaimed) super awesome library (post, GitHub) roncli's strongly typed LibWowAPI (GitHub) NOT MAINTAINED Ruby Frey's Ruby wrapper for Battle.net APIs (GitHub, RubyGems) Milhouse's Ruby wrapper for Battle.net APIs (post, GitHub, RubyGems) Game-specific Resources Hearthstone vamp's hearthstoneapi.com provides a public API (post, site) World of Warcraft Eleadon's spreadsheets for pets, items, realms, spells, and more (post, GitHub) erorus's Random Enchant Suffix List (post, GitHub) erorus's shared info about Battle Pet BreedIDs (post) erorus's table of PvP ladder specs IDs to class and spec name (post) Ulminia's quick guide to exporting WoW icons (post) Ulminia's dump of spell/item icons and talent BGs for 6.0.3 (post) Talonos created a dump of all Battle Pets (post, PasteBin) Ulminia's JSON dictionary to convert enchant IDs to en_US strings (post, Gist) Gluttony's SQL table that maps enchant effectid, spellid, and itemid to slot and name (post, Gist) AresBale's list of item stats (post) MightyOrh's Item Dump (JSON & CSV) (post, DropBox) thedeadwalkk's Item Dump (TXT, SQLite 3) (post, BitBucket) erorus's 6.2 item bonus list dump (Gist, post) dos's SQL table maps enchantIds to descriptions (post, Gist) erorus' map of artifact traits and ranks to spell IDs (post, Gist) vamp's guide for tracking Mythic+ Dungeons (post) erorus' Uncommon Tooltips (post, Github) Game-specific Examples World of Warcraft Kamenitxan's forum signature generator (GitHub) Kamenitxan's HTML guild roster generator (GitHub) AresBale put together a PHP class to help get started with the WoW API (post) Vilepickle created a guild progress widget in PHP (post, GitHub) Throkwa's WordPress plugin for fetching character and Guild data (post, WordPress) Aurifex85 Aug 13
Aug 6 Unofficial Blizzard API Discord In an effort to improve the community of 3rd party developers working with the battle.net APIs and provide a platform for more real-time discussion, I've created a Discord server. My hope is that this Discord is used for sharing our experiences with the battle.net APIs, supporting each other in building awesome things using the APIs, and generally discussing related technologies. Invite link: https://discord.gg/CVxtmes This server is not official, nor is it controlled or endorsed by Blizzard. Anybody is welcome to join though!Sapu16 Aug 6
Jan 2 World of Warcraft Game Data APIs Preliminary Release World of Warcraft Game Data APIs Preliminary Release Greetings adventures! It is with great excitement that we come to you today with an update on the Game Data API's. Previously, we revealed Blizzard's plans moving forward on our vision for future large scale updates to our web API's in this post, and we are excited to finally release some of the data that we have been publishing to the Game Date API for the World of Warcraft franchise. If you wish to dig into the new API's now, you can start experimenting with the API Docs by selecting "World of Warcraft Game Data APIs - <region>" from the drop-down. Scope of Release: We anticipate these APIs to continue to evolve as we further define some concepts and practices, and as such, the structure and available data contained within the documents are subject to change. This release includes both data that is currently available in the World of Warcraft Community APIs, as well as new data that has not previously been released such as the WoW Token and the Mythic Keystone Leaderboards. Available APIs: Connected Realm API Realm API Region API Mythic Keystone Leaderboard API WoW Token API Documentation: Much like our existing D3 Game Data API's, and Community API's for World of Warcraft, SC2, and D3, you can experiment with the World of Warcraft Game Data API's on the API Docs by selecting "World of Warcraft Game Data APIs - <region>" from the drop-down. Along with the API Docs, there is an ongoing effort to add further documentation as well as improve existing documentation in the guides section of dev.battle.net. Along with this release, will be adding a Game Data API Overview, as well as a World of Warcraft Game Data APIs Overview on the guides section of dev.battle.net. Authorization: As outlined in the initial reveal post for the Game Data APIs, consumers will be required to use the Client Credentials OAuth Flow when consuming the World of Warcraft Game Data APIs, which requires providing an Access Token with every request. Core Concepts: With the World of Warcraft Game Data APIs we have taken a new approach to how we build, structure, and consume our APIs. Some of the core concepts are listed below, however, the World of Warcraft Game Data APIs Overview on the guides section of dev.battle.net should be referenced for more in-depth descriptions of these concepts. Document Based: Historically the World of Warcraft Community APIs have returned JSON payloads which may include references to many resources by a numeric ID or a string slug, and were a composite aggregation of multiple data sets. With the World of Warcraft Game Data APIs, we have moved to a self-discoverable document based structure where resources aim to "link" to child / related documents and resources rather than inline a unique identifier. Self Documenting and Discoverability: As mentioned above, where the World of Warcraft Community APIs have historically referenced related resources using an inline ID or other unique identifier such as a slug, the World of Warcraft Game Data APIs aim to reference related documents using a "link" object referenced by a "key" property, which will contain a href property that provides the direct URL resource that can be requested to access a related resource. WoW Community API Pattern: Given the below example of a reduced character response, if the consumer wanted to also retrieve information about the realm, they would need to URL encode the realm name, and then construct the realm request endpoint. { ... "name": "Maguthul", "realm": "Test Realm", ... } WoW Game Data API Pattern: Given the below example of a reduced character document, a consumer who wanted to retrieve information about the realm could simply access the realm.key.href value and make a request with that URL. { ... "name": "Maguthul", "realm": { "key": { "href": "http://us.api.battle.net/data/wow/realm/12345" }, "name": "Test Realm" } ... } You can read more about documents, as well as child document links on the following guide pages: Game Data API Overview World of Warcraft Game Data APIs Overview Localization: Similar to the World of Warcraft Community APIs, the World of Warcraft Game Data APIs will offer localized strings for many of the resources that are available for World of Warcraft's supported locales. New with the World of Warcraft Game Data APIs is that requests can now be made to resources without specifying a locale, which will return all of the available localizations for a resource. If a localization is provided with a request, the response will only include the strings for the requested locale, which will drastically reduce the payload size of some resource responses. A consideration of this new pattern is that based on the existence or absence of a request localization, the response object will be structured differently. You can read more about the localization strategy in the World of Warcraft Game Data APIs on the World of Warcraft Game Data APIs Overview. We are excited to hear your thoughts feedback on these new APIs, so please feel free to reply below. Lok'tar ogar!Maguthul30 Jan 2
Dec 8, 2014 Announcements & API Updates (updated 2018/04/10) This thread was created to make it easier for the community to keep track of major announcements related to the Battle.net API platform & game APIs. The API team will work to keep the post list up to date with our current announcements. Policy Updates UPDATED: Battle.net API Terms of Use on Nov. 5, 2015 UPDATED: Battle.net API Terms of Use FAQ on Nov. 5, 2015 Service Updates Introducing the Game Data API and Profile API on Oct 20, 2016 CN Region Network Migration – Thursday 5/12 PDT on May 10, 2016 Update for Mashery Local: Feb 23 (CN only) on Feb. 5, 2016 Notice: Legacy API Shutdown Test In Progress on Feb. 5, 2016 KR APIs Temporarily Offline 11/19 (KST) on Nov. 16, 2015 °˖✧◝ Shutdown Date for Legacy Endpoints ◜✧˖° on Oct. 26, 2015 Old API endpoints temporarily disabled on Oct. 26, 2015 OAuth Token endpoints now do not return accountId on July 15, 2015 /oauth/token endpoints require POST on April 30, 2015 APIs now support gzip on Dec. 8, 2014 Old API endpoints temporarily disabled (+WoD Update 2) on Nov. 6, 2014 API Call Limits on Nov.13, 2014 New Battle.net API Site and OAuth support! on July 30, 2014 WoW Updates WoW GDAPI Update: Static Namespace Aliases on Apr. 10, 2018 WoW GDAPI Update: Release PlayableClass & PlayableSpecialization on Apr. 10, 2018 WoW GDAPI Update: Mythic Challenge Mode + Mythic Keystone Leaderboard Structure Changes on Jan. 26, 2018 WoW API Update: PvP Leaderboards on May. 23, 2017 Static Render Domains Update on Nov. 15, 2016 (wow thread) Current active Web Armory Profile issues (x-post) on Sep. 7, 2016 (main thread) WoW API Update: zone & boss endpoint additions on Jan. 8, 2016 WoW API Update: zone & boss endpoint additions on Jan. 8, 2016 WoW API Update: auction house static url migration on Nov. 25, 2015 WoW API Update: battlePet endpoint deprecated on Oct. 29, 2015 WoW API Update: pet & mount endpoint additions on Oct. 29, 2015 PSA: New Changes Coming to AH/Realm Data in the APIs on July 30, 2015 WoW Talent API Spec Update on Feb. 13, 2015 WoW 6.0.2 API Updates on Nov. 6, 2014 D3 Updates Diablo 3 Patch 2.4.1 Changes on Apr. 26, 2016 Diablo 3 Leaderboard APIs Now Available! on Aug. 28, 2015 SC2 Updates StarCraft II Client API Update on Nov. 15, 2016. StarCraft II Client API Update on Oct. 7, 2016 Classic Games Classic Chat API Alpha v1 (x-post) on May 5, 2017 (main thread) Forums New MVP: unbound! on May 8, 2017Aurifex0 Dec 8, 2014
16h Items API Returns 504 instead of 404 If you make a call to the items API, with an Item ID that does not exist, most of the time a 504 is returned. However in some cases, the API responds with a 504 Gateway Timeout. This is unexpected behavior. An example URL this happens with is this one: https://us.api.battle.net/wow/item/22459?locale=en_USYakattak0 16h
20h Item API Hey guys! I'm trying to build a database of all wow items ingame, including their source. The list of items, zones and bosses seems complete, but I'm running into a problem: for all newer items (since BfA?), the API returns sourceType NULL and sourceId 0. Any other way to link items that drop from bosses to the respective boss?ChrisKoe1 20h
1d Blizzard please update API Media Documents page I recently was trying to find how to access the icons as provided through the API, and kept finding mixed information about what to use. I've pasted my response that I commented on here https://us.battle.net/forums/en/bnet/topic/20769009235 ... So I ask that this page ( https://dev.battle.net/docs/read/game_data_apis/world_of_warcraft/media_documents ) be updated to have the latest render link, or even to potentially make a new page along side the Character Renders page to show this off.TylorF1 1d
1d Retrieving actual image from icon code Hello, I just dived into the Community API and checked a few endpoints. I realized that most icons are just codes and not paths to actual JPG files. What is the actual method to retrieve real images from those icon codes? Thank you in advance! Skyluxskylux1 1d
2d Are Battle.net IDs unique across regions? I don't need to worry that there's a user in region US with an id of "100000" and a different user in region CN with an id that's the same, do I?Catsclaw4 2d
2d [API req]: alternative to "search/account-by-name"? Hello, i am Roberto, the founder of www.oversearch.it. The user register on website by a button that use the API, so we get BATTLETAG and ID. After this, we get basic player info by the json in this url: https://playoverwatch.com/it-it/search/account-by-name/BATTLETAG With this, we get level, portrait and carrier link. Problem is when the user change the battletag in game, we lost the sync... It there an alternative to "search/account-by-name"? Maybe a way to search by the ID (i suppose that the numeric id does not change when the user change the battletag ). ThanksRpone3 2d
3d Warfront Contribution Progress Hey guys, Keen to get some applications developed to track the progress of the current Warfront Contribution Phase, it would be great to have some data made available so that we can track the progress outside of the game. CheersCazz0r3 3d
3d AH Api actual sells Hi, I'm experimenting with the AH API, and as far as I understood, the API only give you the current auctions, and the estimated time left. Since the auctions dump is available in 1hour intervals, when there is an auction that has a time left of 30min to 2hours and it's not there anymore in the next dump, I can't tell if the item was expired ou sold. Even with longer auctions, the item could be cancelled by the owner or sold. What's the best approach to discover which items were actually sold? Thanks in advance...rbasniak3 3d
4d How to manage error generate when item don't exist ? Hello, I'm still on my whishlist app for items and I need to create a list of all wow items but I have a problem when I make a loop when item's Id doesn't exist ... for($itemId = 1175; $itemId <= 1178; $itemId++){ $item = new Item($itemId); $itemName = $item->getItemName(); $itemClass =$item->getItemClass(); echo $itemId.' '.$itemName.'</br>'; } class Item{ private $itemData; private $name; private $description; private $icon; private $dropId; private $itemClass; function __construct($itemId){ $jsonConnect = new JsonConnect(); $apiReq = $jsonConnect->getItem($itemId); $this->itemData = json_decode($apiReq, true); $this->name = $this->itemData['name']; $this->description = $this->itemData['description']; $this->itemClass = $this->itemData['itemClass']; } //return all Item's data public function getData(){ return $this->itemData; } //return Item Name public function getItemName(){ return $this->name; } public function getDescription(){ return $this->description; } public function getItemClass(){ return $this->itemClass; } } class jsonConnect { public function getItem($itemId){ $item = file_get_contents('https://eu.api.battle.net/wow/item/'.$itemId.'?locale=fr_FR&apikey=xxxxxx'); return $item; } } ptimimi3 4d
4d Gather all Blue Posts Hey guys, i have a question. How are these Blue Tracker working for example from "wowhead" Are they just grabbing Each Forums Data and then try to export the blue post of the whole data? Or ist there something like an feed that from Blizzard itself to grab this data? My idea behind ist that i want to buld some little helpers for my guild and one would be a own Bluetracker because the kind how wowhead is showing the blue Posts arent that what we want. I want do some own filtering and so on to the data. But before i can do it i need an idea how i can grab all this Blue posts. If someone as an idea pls let me know. I would relly appreciate it! If there comes something out in the end that could be useful for everyone i will share it in the end with the communityOrbitus0 4d
4d How to get Account ID How do I go about getting the Account Id for the person that is authenticating with oAuth2? I'm using a lamp stack right now and am successfully able to authenticate without issues, however I don't see anything in the docs regarding how to obtain the users Account Id?Rubin1 4d
4d Reviving the Overwatch API Request Just started playing Overwatch not too long ago and wanted to start looking into some of the APIs, only to discover that there aren't any. It has been brought up in the past but looks like nothing is coming from it other than "scraping". Are there any updates that I'm missing? It's nice being able to view detailed match info from the past and also live details such as who I'm up against and their info.CrazyJabber16 4d
4d Request to show more runs in Mythic Keystone Leaderboard/API Hi there, I run a site called Raider.IO, and Mythic+ tracking is a big part of the features we've developed. We do our best to work within the constraints of the provided APIs and leaderboards. However, the recent change to make +15 the bar for getting maximum chest loot each week has rendered the current Mythic Keystone leaderboards/APIs fairly ineffectual at showing progression of users who are not pushing high keys, since their runs are not high enough to make it into the new "bar" that people push for (especially if they are on a high pop realm). While having a more full-fledged API to query would be great, I wanted to make a smaller request in case it might be something that can be done with more expediently and with less risk from Blizzard's side: Would Blizzard be open to just extending the current Mythic Keystone Leaderboard/API to return the Top 200 runs for the week instead of the Top 100? (Higher numbers would be even better, but I understand there must be a limit somewhere). Thanks for taking the time to read this.Comfort7 4d
4d Rare and Treasure quests? It looks like the Rare and Treasures in WoD are tracked internally as quests. However, they don't seem to be returned via the API when you query for quests. I'm seeing all the WoD quests I completed, but it skips over the numbers for the rares and treasures. Anyone know if there is a new way to get these? Or is this a known bug? I can't find any posts here even mentioning it. Thanks!Aset2 4d
4d SC2 lastmatches endpoint returns 500 I already posted it a while ago in APi error forum, but sadly no response, so I'm trying my luck here. Currently if the player plays any co-op mission, his endpoint for last matches returns Internal Server Error for as long as this match is included in his last matches (around 25 matches i think) Example: https://eu.api.battle.net/sc2/profile/6524482/1/kertoip/matches?locale=en_GB&apikey=XXX Is there a chance that this will be fixed ever, or should I find another means to gather match history?exeq0 4d
5d Multiple Characters in one API request? So I'm trying to pull the average ilevel for an entire guild. The guild endpoint allows me to pull all members in one call but the member data appears to be missing ilevel. Is there a way to request ilevel here? Alternatively is there a way to request multiple characters from the character endpoint in one call as here I can query items. Apologies if this is a silly question.Scoops7 5d
5d Anti cheat whitelisting We're developers working on a streaming App targeted to people who want a no-hassle solution for sharing their live game-play with friends (think Twitch, but with a dead-simple setup plus integrated voice so people can talk as they watch live). To capture frames without impacting performance, we hook DirectX (same technique that OBS, Caffeine.tv and others use). Since this may trigger an anti-cheat flags, we'd like to work with Blizzard and follow any established protocols to be white-listed as a social App. What's the best channel of communication to do so? Happy to provide more details on our company there. As helpful, we've already been white-listed by providers such as EasyAntiCheat and BattlEye.Entropy0 5d
6d Request relationship with any third-party brand owners represented in App. I uploaded an app in the App Store called "Diablo3 Dual" which uses D3 Community Api. I uploaded it again to fix the app bug, but it have been rejected for design copycat during app review. Apple requests "Please demonstrate your relationship with any third-party brand owners represented in your app." So I would like to ask you for the related information of document. Thank you. Refer to the app store address. https://itunes.apple.com/us/app/diablo3-dual/id1420226643?mt=8LazyTurtle0 6d
6d Continuation token on pvp API Can you add a continuation token (or some other paging system) to the list of pvp results? Right now it returns the top ~ 5000 players or so, which takes us down to 1800 rating. I want to determine what the player percentiles are at each rating threshold (1500,1600,1700 etc). ThanksSilverBullet0 6d
Sep 16 8.x M+ API Returning some Characters with name "Unknown" Hi there, I believe there is a problem with the recent updates for 8.x that is causing some characters to be returned from the M+ group listing with an improper name of "Unknown" (at least these characters never exist in armory/API in the cases I've seen this afternoon). https://us.api.battle.net/data/wow/connected-realm/3678/mythic-leaderboard/198/period/655?apikey=<YOURKEY>&access_token=<YOURTOKEN>&locale=en_US&namespace=dynamic-us Edit: With this one having previously been marked as spam, I had made another post here with fewer links: https://us.battle.net/forums/en/bnet/topic/20765747452Comfort5 Sep 16
Sep 13 Champion Equipment missing from AH Data - No longer BoP Regarding the crafted Champion Equipment items listed here: https://www.wowhead.com/other-consumables?filter=107:86;0:11;mission:0 BFA launched with those items being BoP, but they were quickly changed to Binds when used, so they could be sold on the auction house. The API has lagged behind and still considers those items to be BoP. This means the item API is out-of-date, but more importantly, those items are not showing up in the auction house data, even though auctions for those items exist. Please update your item database so those items which are on the auction house show up in the data. Thank you.erorus2 Sep 13
Sep 13 Character Profile API 500 error There seems to be serveral errors on character profile apis. These are sample urls: https://kr.api.battle.net/wow/character/Azshara/법사은아?fields=guild&locale=ko_KR&apikey= https://kr.api.battle.net/wow/character/Azshara/법사은아?fields=items&locale=ko_KR&apikey= This character is exists but server responses 500 internal error. There are more characters causing internal errors not this one. For example, '끼으아악' also causes error. Please check. Thank you.RogueKim0 Sep 13
Sep 12 Mythic Raid Leaderboards (Hall of Fame) API Greetings all, Yesterday with the opening of Mythic Uldir, we released a new Mythic Raid Leaderboard over on worldofwarcraft.com, and along with this, we are also releasing the Game Data API documents which are used to power these new leaderboards. You can find examples of the new document(s) below (you will need a valid access token): Please note that the documents will not include any entries until guilds for the specified faction begin to be awarded the Hall of Fame achievement. https://us.api.battle.net/data/wow/leaderboard/hall-of-fame/uldir/alliance?namespace=dynamic-us&locale=en_US&access_token= https://us.api.battle.net/data/wow/leaderboard/hall-of-fame/uldir/horde?namespace=dynamic-us&locale=en_US&access_token= An example of a document which includes populated entries can be seen below: { "_links": { "self": { "href": "https://us.api.battle.net/data/wow/leaderboard/hall-of-fame/uldir/horde?namespace=dynamic-us" } }, "slug": "uldir-horde", "criteria_type": "hall-of-fame", "zone": { "key": { "href": "https://us.api.battle.net/data/wow/zone/9389?namespace=static-us" }, "name": "Uldir" }, "entries": [ { "guild": { "name": "Cool Guild 1", "id": 12345, "realm": { "name": "Cool Realm 1", "id": 12345, "slug": "cool-realm-1" } }, "faction": { "type": "HORDE" }, "timestamp": 1536769397000, "region": "us", "rank": 1 } ] } Each document will include all guilds for the specified faction that have received the achievement, regardless of region, where possible values for the region are us, eu, kr, tw and cn. These documents are also replicated to each regional instance of the Game Data API (using eu & kr as examples): EU: https://eu.api.battle.net/data/wow/leaderboard/hall-of-fame/uldir/alliance?namespace=dynamic-eu&locale=en_US&access_token= https://eu.api.battle.net/data/wow/leaderboard/hall-of-fame/uldir/horde?namespace=dynamic-eu&locale=en_US&access_token= KR: https://kr.api.battle.net/data/wow/leaderboard/hall-of-fame/uldir/alliance?namespace=dynamic-kr&locale=en_US&access_token= https://kr.api.battle.net/data/wow/leaderboard/hall-of-fame/uldir/horde?namespace=dynamic-kr&locale=en_US&access_token= Please let us know if you experience any issues with these new endpoints.Maguthul0 Sep 12
Sep 12 Pet battle list for BFA Hello, does somebody has an updated list for the battle pets which came with Battle for Azeroth? I need informations about which breeds are available and which qualities. Thank you.Treeman0 Sep 12
Sep 12 Mythic Keystone Tracking (The key itself) Unless I'm missing something, is there really no current way to track what keystone a character has? I was looking at the Character Feed endpoint and found a keystone that my character looted from the Weekly Chest, however there is no real detail as to the level of it or the dungeon it is for. Could we kindly get this information somehow? Keystone { "type": "LOOT", "timestamp": 1536690546000, "itemId": 158923, "context": "", "bonusLists": [] } ItemID Endpoint { "id": 158923, "description": "Place within the Font of Power inside the dungeon on Mythic difficulty.", "name": "Mythic Keystone", "icon": "inv_relics_hourglass", "stackable": 1, "itemBind": 1, "bonusStats": [], "itemSpells": [], "buyPrice": 2000, "itemClass": 5, "itemSubClass": 1, "containerSlots": 0, "inventoryType": 0, "equippable": false, "itemLevel": 1, "maxCount": 0, "maxDurability": 0, "minFactionId": 0, "minReputation": 0, "quality": 4, "sellPrice": 0, "requiredSkill": 0, "requiredLevel": 1, "requiredSkillRank": 0, "itemSource": { "sourceId": 0, "sourceType": "NONE" }, "baseArmor": 0, "hasSockets": false, "isAuctionable": false, "armor": 0, "displayInfoId": 0, "nameDescription": "", "nameDescriptionColor": "000000", "upgradable": true, "heroicTooltip": false, "context": "", "bonusLists": [], "availableContexts": [""], "bonusSummary": { "defaultBonusLists": [], "chanceBonusLists": [], "bonusChances": [] }, "artifactId": 0 } Kryo0 Sep 12
Sep 12 Zone API Update for BfA Hi When the Zone API will get update including BfA content? Such Uldir, Freehold, The Underrot, etc. https://us.api.battle.net/wow/zone The Items API already return results for the drops of those instances but with an NONE sourceType https://us.api.battle.net/wow/item/160686 The Encounter Journal within the live game, and the related LUA API, has been updated. I was expecting that the REST API is update as the in game API isLatok5 Sep 12
Sep 11 Informative website Hi I would like to make a informative website about The World of Warcraft and I have read about https://dev.battle.net/ and it gives me an API in the page https://dev.battle.net/io-docs, but I have only seen endpoints such as Realms, Bosses ( by the way, this endpoint not return me the thumbnail ), Pets, etc. I would like to make a website like wowhead, but not than completed like it, else an informative website to show information to the comunity in my country. I don't know if the API website of Blizzard it's going to work. I don't know how pages like wowhead gets all the information about World of Warcraft. Do I need to collect the information manually ? What would you recommend me ? Thanks so muchKakashisama0 Sep 11
Sep 11 The 2018 "Can we have a toy API please?" thread As above, could we have a toy API please? <3cuddlywookie4 Sep 11
Sep 11 how detect that pet is cageable pls help, what field in json reflects this propertyAnzor6 Sep 11
Sep 10 [WoW] Auction API questions Hi everyone! I start creating some auction app, but I can't found some information in docs... * First of all - how often data updates? 1h or more often? * Then - how can I know which type this auction position - Alliance, Horde or Neutral? So owner's faction can give me auction position faction, but how to know is it Neutral? * And in the end - what is "rand", "seed", "context" fields? Is somewhere description for all fields of all API methods? Thanks!Softer6 Sep 10
Sep 10 Mount itemId - not sure how to read allowableRaces. Mount itemId - not sure how to read allowableRaces. For instance, Swift Green Wind Rider, which returns itemId=25531 shows allowable races: [2, 2, 5, 5, 6, 6, 8, 8, 9, 10, 10, 26, 27, 28, 34]. Why are 2, 5, 6, 8, and 10 duplicated? Why is 34 on the list? Under Races that comes up as Dark Iron Dwarf. All of the other ones are keyed to Horde races. Am I not reading this right?CrJabes1 Sep 10
Sep 10 [solved][Auction API] Some character names appear incorrectly (ç -> ç) ) Edit: Problem solved. It was a fault in my lambda function. There seems to be an issue with some character names in the auction API. The name Badunça is returned correctly from the character API., but in the auction API dump it appears as Badunça I would assume that this is not intentional, but maybe caused by different character encodings (not UTF8 I guess).Ukon4 Sep 10
Sep 10 Mythic+ Achievement Criteria not working I've tried to find a way around the mythic+ leaderboards to detect if someone has done a +10 key in the current reset. The closest i got was detecting the +10 achievement on the character (id is 11185) and then checking up the criteria (id is 33098), finding the criteria index and querying the criteria timestamps to get the last completed 10+. It works perfectly fine for +2 and +5 achievements (criteria id 33096,33097) but for the +10 one it doesn't work, and it only shows up to BfA release. P.S : Just so this doesn't get written off on this, i know for a fact few people in my guild that did 10+ it still doesn't apply for them.Vulegends0 Sep 10
Sep 10 Diff beetween API and real data Hey guys, I'm developping a little app to get all the mounts collected by a character, all non collected etc. I use /wow/character/:realm/:characterName to get mounts collected by the given character. When I used this endpoint, the API return 85 mounts. In game, I see 119 for this character. I don't understand this result :( Thanks for your help !Azorgh0 Sep 10
Sep 10 API to get item id from id name Hello, That's not possible to get the item ID from the item name ? In JSON file or something like. I'm trying to build an app and it's more user-friendly if the user types the item name instead of looking on wowhead or add on in game and paste his item ID... Thanks a lot I'm a bit stuck since few days on it :(Sylrus0 Sep 10
Sep 8 WoW API Update: pet & mount endpoint additions Well Met Community Developers! I wanted to take a moment to update you on some new features / endpoints in the World of Warcraft Community API. The following endpoints are now live and should be ready for your consumption: PET API /pet { "pets": [ { "canBattle": true, "creatureId": 45128, "name": "Crawling Claw", "family": "undead", "icon": "inv_offhand_stratholme_a_02", "qualityId": 4, "stats": { "speciesId": 264, "breedId": 3, "petQualityId": 1, "level": 1, "health": 150, "power": 10, "speed": 8 }, "strongAgainst": [ "humanoid" ], "typeId": 3, "weakAgainst": [ "water" ] } ... ] } MOUNT API /mount { "mounts": [ { "name": "Grey Riding Yak", "spellId": 127216, "creatureId": 65017, "itemId": 87788, "qualityId": 4, "icon": "ability_mount_yakmountgrey", "isGround": true, "isFlying": false, "isAquatic": true, "isJumping": true }, ... ] } These endpoints should return a list of all pets or mounts, respectively, which are currently supported. We are working to add these new endpoints to the documentation on https://dev.battle.net/io-docs shortly. -MaguthulMaguthul11 Sep 8
Sep 7 API down? I'm getting "Character unavailable" for every character query. Confirmed that Wowhead cannot retrieve the character info either.Kula20 Sep 7
Sep 7 dungeon progression Hi guys! I would like to get info about dungeons. Is there a method to do that? Something like the progression method in the Character Profile API. I noticed this one only provides raids info. Thanks.uborZz9 Sep 7
Sep 7 WoW Quest API - Pretty Please! Hey, I love the fact that you guys have provided us with at least some basic quest information via the community API (Albeit there does appear to be certain quests not appearing ), but the information is really basic and hasn't been updated\added to in any way since it was first released. I would be forever grateful if you guys would consider adding at least some additional data to the quest queries, for example bitfield(s) for what Class\Race\Faction a quest is available to? Is this likely to ever be considered? I naturally don't know how you guys have everything set up, but it feels like it wouldn't be a massive amount of work, but would be incredibly useful for people like myself who develop quest related addons. Thanks in advance.Viduus2 Sep 7
Sep 7 OAuth character endpoint returns erroneous guild data Hi there, I just realised that the "/wow/user/characters" endpoint of the Community OAuth Profile API (EU) returns wrong guild data in some cases. More specifically, I have a couple of characters for which the payload contains a guild name, although those characters left their guild several months ago. The guild is the last one they were in, but it should have updated and be empty now. Would it be possible to update this field so it returns the character's current guild or null? Thanks for your help!Keden2 Sep 7
Sep 6 Can I access calendar data? Hi, I'd like to be able to progamatically get access to the guild calendar events, and wondered if this was possible or not? Would the new OAUTH allow that? I want to see who is signed up for guild raids.Whisperer70 Sep 6