API Discussion

May 8 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
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
Jul 24 [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). Here is the Alpha of my project called "Manatools". I'm currently working on tools to optimize class on World of Warcraft, like creating a virtual armory to help player to find their "Best in slot" items, a scanner to find items and battlepet in the auction house. Name : Manatools Platform : Web Code : PHP / AngularJS http://www.manatools.com/ Gym67 Jul 24
Apr 4 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.Andanion18 Apr 4
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
4d 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!Maguthul27 4d
Jun 22 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) 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)Aurifex80 Jun 22
Jun 20 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!Sapu13 Jun 20
Dec 8, 2014 Announcements & API Updates (updated 2017/05/08) 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 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 PvP Leaderboards Update on May. 23, 2017 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
4h Data Analysis of Diablo Live and PTR Leaderboards (via API) Hi, I would like to be able to extract the Diablo 3 leaderboard data for class balancing purposes. I will need to extract Greater rift level, clear time and paragon level (and possibly all other possible data). From what I understand, I can create a mashable account and request this information as required. Is that correct?Prokahn8 4h
1d Overwatch API Request Time stamps. I built a site for Destiny called Guardian Theater (http://guardian.theater/) which mashes up activity time stamps and player lists from Destiny with Xbox clips to show off all of the clips recorded by all participants during an activity. I had hoped to build a similar site for Halo 5, but they don't include time stamps in their API. I'd like to build something similar for Overwatch, so it would be greatly appreciated if you included time stamps in the (nonexistent, unannounced) API. If you were to time stamp events within a match to aid in the filtering of clips (something the Bungie API does not do), I'd love you even more.chrisfried39 1d
1d kr data/sc2/season/current incorrect data KR current season endpoint is returning incorrect data Currently we are in season 33, but the KR end point believes that the server is still running in season 32 https://kr.api.battle.net/data/sc2/season/current { "_links": { "self": { "href": "https://kr.api.battle.net/data/sc2/season/current?namespace=prod" } }, "id": 32, "year": 2017, "number": 2, "start_timestamp": 1493836939, "end_timestamp": 1500488354 } NA server response https://us.api.battle.net/data/sc2/season/current { "_links": { "self": { "href": "https://us.api.battle.net/data/sc2/season/current?namespace=prod" } }, "id": 33, "year": 2017, "number": 3, "start_timestamp": 1500401314, "end_timestamp": 1510300800 } breath203 1d
1d URL for achievement icons in WoW Hello there, I was wondering if someone knows the location of the wow achievement icons. For example: "icon": "achievement_bg_masterofallbgs" From what I've found it should be somewhere in http://media.blizzard.com/wow/icons Thanks :)PoisonMike4 1d
1d D3 clan list call Does any one know if there is a way to have a list generated based on diablo 3 clan roster? If not, is it in the pipeline of possibility? Thanks!Infernal4 1d
2d Can you extract build orders a Starcraft II account's match history with the API? I can't seem to find a way to do it, and just want to make sure if it was possible before deciding to quit searching.Operator0 2d
3d [North America] SC2 Oauth Ladder Endpoint DNS Failure I've noticed since yesterday (~15 hours) a DNS issue with the data API endpoint. lax1-api-data-active-vip.battle.net’s server DNS address could not be found. breath, the developer at sc2replaystats.com has also confirmed this issueOphidian2 3d
4d API account inactive - using PHP wowarmoryapi (sourceforge) Hey there everyone, I have a website under development dedicated to a certain guild that I am working on, a big part of the info displayed on the website are fetched from the wow API, so far I have been using the following API: https://sourceforge.net/p/wowarmoryapi/home/Home/ And it worked fine for several weeks even until yesterday when I was surprised to see that the API was unable to fetch data anymore, trying to figure out the problem I created a separate page in order to test the actual API. Here is the code I tested and the result I got : Code: <?php $GLOBALS['wowarmory']['db']['driver'] = 'mysql'; $GLOBALS['wowarmory']['db']['hostname'] = 'localhost'; $GLOBALS['wowarmory']['db']['dbname'] = 'endeavourwow'; $GLOBALS['wowarmory']['db']['username'] = 'root'; $GLOBALS['wowarmory']['db']['password'] = ''; $GLOBALS['wowarmory']['keys']['api'] = '<api key (censored)>'; include('php/wowarmoryapi/BattlenetArmory.class.php'); $armory = new BattlenetArmory('EU', 'The Maelstrom'); $armory->setLocale('en_GB'); $character = $armory->getCharacter('Velaeria'); $guild = $armory->getGuild('Endeavour'); $members = $guild->getMembers(); var_dump($members); $completedquestsAmount = $character->getCompletedQuestsAmount(); if ($character) { var_dump($completedquestsAmount); } $gear = $character->getGear(); //var_export($gear); ?> As I tried to work further into finding out the problem I tested one simple link : https://eu.api.battle.net/wow/character/The%20Maelstrom/Velaeria?fields=items&locale=en_GB&apikey=(api key) At this I had a certain API key, when I tried to place that key in the above link it gave me the following error: {"code":403, "type":"Forbidden", "detail":"Account Inactive"} So I tried to create a new key on https://dev.battle.net/ and indeed after replacing the old key with the new key and refreshing the page, info were displayed concerning the character which could mean but one thing, the key was working fine and active, so I tried to add it to my code and I got the following results: 2 PHP errors : Notice: Undefined index: global in C:\wamp64\www\Endeavour\php\wowarmoryapi\jsonConnect.class.php on line 167 Notice: Undefined index: global in C:\wamp64\www\Endeavour\php\wowarmoryapi\jsonConnect.class.php on line 167 2 var_dump() results : C:\wamp64\www\Endeavour\test.php:14:null C:\wamp64\www\Endeavour\test.php:17:int 0 Now it was getting a little bit tricky, the key is working fine yet the API was unable to fetch any data, therefore I dug a little bit deeper and tried to use the code displayed in this topic : https://us.battle.net/forums/en/bnet/topic/14059565901 for my amazement this code <?php header('Content-type: text/html; charset=utf-8'); //-- Your Registered API Key --// $APIkey = '<api key (censored)>'; //-- Your Region, Locale & Game --// $RegionName = 'eu'; $LocaleName = 'en_GB'; $GameName = 'wow'; //-- Your Realm, Guild & Player Name --// $RealmName = str_replace(' ', '%20', 'The Maelstrom'); $GuildName = str_replace(' ', '%20', 'Endeavour'); $PlayerName = 'Velaeria'; $json_wow_api_url = file_get_contents('https://'.$RegionName.'.api.battle.net/'.$GameName.'/character/'.$RealmName.'/'.$PlayerName.'?locale='.$LocaleName.'&apikey='.$APIkey.''); echo 'https://'.$RegionName.'.api.battle.net/'.$GameName.'/character/'.$RealmName.'/'.$PlayerName.'?locale='.$LocaleName.'&apikey='.$APIkey.''; echo '<h3>World of Warcraft - API Info</h3><pre>'; var_export(json_decode($json_wow_api_url, true)); echo '</pre>'; ?> gave me the following result: 3 PHP errors: ( ! ) Warning: file_get_contents(): SSL operation failed with code 1. OpenSSL Error messages: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed in C:\wamp64\www\Endeavour\test.php on line 42 ( ! ) Warning: file_get_contents(): Failed to enable crypto in C:\wamp64\www\Endeavour\test.php on line 42 ( ! ) Warning: file_get_contents(https://eu.api.battle.net/wow/character/The%20Maelstrom/Velaeria?locale=en_GB&amp;apikey=(api key)): failed to open stream: operation failed in C:\wamp64\www\Endeavour\test.php on line 42 And the var_export gave out a NULL value, so I tried in the code to echo the actual link https://eu.api.battle.net/wow/character/The%20Maelstrom/Velaeria?locale=en_GB&apikey=zzysqhjnatddsycu5ta7fd76nja333gt being decoded and got the following result : {"lastModified":1502661563000,"name":"Velaeria","realm":"The Maelstrom","battlegroup":"Vindication","class":8,"race":10,"gender":1,"level":110,"achievementPoints":15425,"thumbnail":"the-maelstrom/253/154777341-avatar.jpg","calcClass":"e","faction":1,"totalHonorableKills":380} which is quite bizarre, everything seems to work fine but data is not being fetched when I try to use the API, if you could help me figure out what is going on ill appreciate it. PLEASE NOTE: I would like to keep on using the armoryapi on sourceforge (https://sourceforge.net/p/wowarmoryapi/home/Home/) everything else was there for testing so if you could help me figure out how to get it to work again ill be thankful, and if anyone has any PHP alternative I would not mind as well. Thank you for reading.Jad3 4d
6d How to access static namespace ? Hi ! I am fiddling with the Wow APIs to develop a Dart wrapper, and maybe a Dart Webapp too, but I can't seem to find how to make the API serve me the resources under the static-* namespace. I manage to get https://eu.api.battle.net/data/wow/connected-realm/1335/mythic-leaderboard/197/period/606?namespace=dynamic-eu&locale=en_GB correctly, with my access token, but when I try the same on any of the static resources linked here, like this one https://eu.api.battle.net/data/wow/keystone-affix/7?namespace=static-7.2.5_24287-eu&locale=en_GB, I get back a 403 Forbidden ~ The docs even point to the exact same scenario here: https://dev.battle.net/docs/read/game_data_apis/world_of_warcraft/media_documents, but with no specific explanation, so I assumed there was nothing special to do. Does anyone know how to access the static namespace ? PS: I tried to remove the version and/or build number, change static to dynamic, change the locale (you never know ~), etc... but to no avail.Naliwe2 6d
6d SC2 - Ladder API and character_link Hello everyone, I currently have a problem with the API Endpoint to request character info from the game data API. Following instructions on this page: https://us.battle.net/forums/en/bnet/topic/20752156145 I tried to play around with the SC2 API but I can't seem to get data for a player from the data gathered via the Ladder API. The call to the Ladder API works well, and for each player I have this subarray (here copied from referenced topic): "character_link" : { "id" : 7331, "battle_tag" : "ThePontiff#4567", "key" : { "href" : "https://us.api.battle.net/data/sc2/character/ThePontiff-4567/7331" } }, I may be wrong but when I see this, I understand that the character_link->key->href field leads to another API endpoint, but when I try to request it with my access token, I always have the following (I tried with various players) { "code":404, "type":"BLZWEBAPI00000404", "detail":"Not Found" } Does anyone know if there's an additional parameter that's not indicated, or if the API endpoint is currently broken or just not developped yet (or even the endpoint to get player data is not this one) ? Thanks for your feedback. Regards.Epingle2 6d
Aug 12 Hearthstone Tournaments Calendar API Hey. Is there any API / json to gather data from https://eu.battle.net/hearthstone/en/esports/schedule/ besides making web crawler?Nehel1 Aug 12
Aug 12 I really need help from someone who is smart!!?? Hey guys, question here.. On the WoW API ClassID, deathknights are number 6, but on the WoW character creation screen deathknights are number 12? Does classes still have UnitClassID's? I just don't know why deathknights aren't at number 6 like it is on WoW API? If you can help I thankyou alottt!!!Zmitchell2 Aug 12
Aug 12 Community OAuth Profile APIs Good morning all, When accessing the profile API i always receive the following response: 401 Unauthorized And when inspecting the headers i see this: Content-Type: application/json Date: Fri, 11 Aug 2017 07:21:52 GMT Server: Mashery Proxy Www-Authenticate: Bearer realm="eu.api.battle.net", error="invalid_token" X-Error-Detail-Header: Not Authorized X-Mashery-Error-Code: ERR_403_NOT_AUTHORIZED X-Mashery-Responder: prod-j-worker-us-east-1b-131.mashery.com Content-Length: 59 Connection: keep-alive Do i need to file for additional authority? At first i thought i was doing something wrong, but i get the same responses from the API docs website where the examples are being given.RyuKenDen4 Aug 12
Aug 11 Auction API russian realm names I`m trying to retrieve autcion data for russian realm Гордунни. Everything works fine for realms with only latin characters, but I can`t figure out what should I use for realm name in my case. I`ve tried: гордунни Гордунни Gordunni Ghordunni gordunni ghordunni and also %D0%B3%D0%BE%D1%80%D0%B4%D1%83%D0%BD%D0%BD%D0%B8 which is basicly гордунни encoded into URL format. Not sure if the problem is in realm name or in locale setting (cannot be changed for ru_RU or anything similar). So the qustion is what should I use for realm name argument for russian realms?DagothHertil1 Aug 11
Aug 10 SC2 - League/Season API endpoint documentation? Hi all, Are the SC2 League and Ladder APIs described here https://us.battle.net/forums/en/sc2/topic/20749724960 documented anywhere other than that thread? I don't see anything listed on https://dev.battle.net/io-docs for the /data/sc2/season/ or /data/sc2/league/ endpoints, and want to make sure I'm not missing anything before I go too far. Thanks!Bird0 Aug 10
Aug 8 Last Modified is always 0 in guild feed Hi Blizzard, When using the guild members endpoint (https://us.api.battle.net/wow/guild/[server]/[guild_name]?fields=members&locale=en_US&apikey=[key]) every character's "lastModified" value is always 0. When retrieving characters directly this value is working fine but it would be great to have it working here. Essentially this gives us a tool to see bulk user activity in order to more intelligently update character data on our sites. Obviously if a character hasn't logged in for 3 months there's no point in using API requests to update them.Drenathor0 Aug 8
Aug 8 Mounts, Items and Item Sources Hello guys, I'm the creator of the Telsa Mount Planner found here: http://telsa-productions.co.uk/telsa-wow/web/mount/home I've been having a lot of thoughts recently about expanding how the site can be used and how much data we give for the different mounts people can obtain. Right now I only show a few "farmable" mounts, so the natural progression would be to include the easy to obtain mounts that people can simply go and buy from a vendor. To this end I pulled the mount master list, then took each item ID and pulled all of the items. Then the next idea was to pull all of the item sources based on the sourceType. So if sourceType is a "CREATURE_DROP" then I could pull the data from the boss api, or if sourceType is a "ACHIEVEMENT_REWARD" then I could pull data from the achievement API, and so far everything is absolutely wonderful! I've been loving the changes to the API since I last worked on it a few years ago, and the docs are awesome! But there my luck ended :( I then wanted to look for some NPC or Vendor information, but this isn't exposed by the API that I can see, is there a plan for this to be added in the future? Then I started looking into a few of the mounts/items and found that the itemSource information is seriously lacking in a lot of cases. I have a few examples here: Item ID: 87774 Item Name: Reins of the Heavenly Golden Cloud Serpent Source Type: NONE Pretty sure this one is just a faction reward Item ID: 142552 Item Name: Smoldering Ember Wyrm Source Type: NONE (and sourceID of 0) This one is a drop from a boss in Karazhan So I guess all I'm asking is... How should I be parsing the source information? Is there a plan to update the source information so it's usable? PillarPillar2 Aug 8
Aug 6 WoW: 'Real' itemLevel in item API with context provided Hello, after having spent quite some time to find a way to query the amount of ilvl an item gained through the warforge/titanforge system I have a question / proposal: Question: what itemLevel is returned by item API when context information (but no bonus ids) is provided? So for example https://us.api.battle.net/wow/item/147055/raid-mythic?apikey=XXX returns itemLevel 900, but the real baseline (no WF/TF) drop on mythic is itemLevel 930 and the base itemLevel used for calculations with the bonus ids is 890. So I cannot see where the 900 is coming from. Proposal: if an explicit context is specified in the API call return the 'real' base itemLevel of the item as it drops on given difficulty (context). If there is a reason the source of the returned itemLevel cannot be changed (perhaps it is some kind of base itemLevel for other things), an alternate way could be to automatically add the needed bonus ids to match the real baseline drop (without WF/TF). Perhaps there is also another way but I think it is a pitty to have an item API that does not provide information on what exact 'version' of the item really drops ingame in a given difficulty (context). ThanksSniper0 Aug 6
Aug 4 StarCraft Remastered API? Does anybody know if Starcraft remastered will have an API for pulling game data? Or has this information now been released yet?Serenity6 Aug 4
Aug 3 WoW Game Data API Outage (resolved) Greetings devs, We're currently experiencing an outage related to the Preliminary World of Warcraft Game Data APIs. While we believe we've identified the cause of the problem, we don't have an ETA on a resolution. AurifexAurifex1 Aug 3
Aug 3 [Dump] All World of Warcraft Item IDs as .txt Hello everyone, As I'm working on some stuff with the Blizzard API, I thought I might be sharing some of the ressources I'm creating. So, first thing I've got for you is an item list of all Items (I really hope it's complete) I could find in World of Warcraft. You can find it here: https://github.com/KiaArmani/Blizzard/blob/master/blizzard_eu_wow_allitems_idsonly.txt Found a missing item? Feel free to make a pull request! Also feel free to make requests regarding anything WoW related, maybe I can help out! Sincerely, Kia.Kia2 Aug 3
Aug 3 SC2 replay api Hi, is there any possibility of any interaction with replays sc2 via the API?Flashantik1 Aug 3
Aug 2 Spell API The spell api are returning on description numbers instead of percentage value. What attack power or spell power blizzard are based on it? Example: { "id": 19434, "name": "Aimed Shot", "icon": "inv_spear_07", "description": "A powerful aimed shot that deals 141,295 Physical damage. Damage increased by 50% against a target you have not yet damaged.", "range": "40 yd range", "powerCost": "50 Focus", "castTime": "1.5 sec cast" } Is there a way to get the percentage value like wow head? Example: Aimed Shot 50 Focus 40 yd range Instant cast Requires Hunter (Marksmanship) Requires level 12 Requires Ranged Weapon A powerful aimed shot that deals [425% * ((max(0, min(Level - 10, 10)) * 8 + 130) / 210)] Physical damage. Damage increased by 50% against a target you have not yet damaged.SkullOx2 Aug 2
Aug 1 HotS Companion Android App Suspended - Need Help EDIT: Latest Response from Google: "Unfortunately, we were not able to validate your account's relationship to Heroes of the Storm with the information provided. In order for us to process your appeal, please reply with a signed letter that Blizzard Entertainment is giving you their permission to use their content. A document in PDF form will be acceptable. Please be advised we will not be able to respond or reinstate your application without the above documentation." END EDIT - Original Post below: Hi, I am again having some issues with Google Play Support, they have once again suspended my Application. Last time was 1.5 years ago and I managed to get some help from Andanion and got it back after a few weeks. As it stands now it is being suspended due to "Impersonation" violation. I have used the same Title and Icon for a very long time now so this suspension came as an unwanted Christmas gift. The App is the "HotS Companion - Heroes App" (id com.app.hots.skills.talents). This App has been around for over 2 years and was the first and biggest HotS App ever on Android serving around 150 000 HotS Players with nifty features and up to date information of HotS over the years. Cached Link to App: http://webcache.googleusercontent.com/search?q=cache:https://play.google.com/store/apps/details?id=com.app.hots.skills.talents Their issue is "Our policy states: We don’t allow apps that use another app or entity’s brand, title, logo, or name in a manner that may result in misleading users. Don’t try to imply an endorsement or relationship with another entity where none exists." The App description clearly states it is an unofficial App in the very beginning and it also contains the copyright information as described by your legal FAQ. I have tried to explain this but they will have none of it. They want "verifiable proof of permission" that I am allowed to have this App. So if one of you could assure them either in this thread( and I will send them the link to it) or in some other way that this App is permitted to exist that would be wonderful. As it stands now no one can download the App and I can't upload updates for it so I am unable to get the latest Patch Changes into it, so some of my users are getting restless waiting for them. A quick resolution is greatly appreciated. Thanks in advance!Gnejs107 Aug 1
Jul 31 Mythic+ Leaderboard / API Only Shows Highest Level Run Per Team Hi there, We've noticed that if the same team runs a dungeon multiple times that only their highest mythic+ level shows on the leaderboards (and the API). This is particularly problematic in the following case: Player runs a high key (say a +23 BRH) and takes many hours to complete it. Later in the same raid week this exact group runs a +22 BRH and 2-chests it. Because they had previously done a +23 BRH that week, their +22 BRH would not show on the leaderboard at all. On Raider.IO we depend on these data to build Mythic+ rankings. We have a scoring system that values time as part of the score calculation, so it would be very likely that this in-time +22 BRH would be "worth" more than the multi-hour +23 BRH (from our system's perspective). Would you be able to expose a way for us to get at all the runs during the week, regardless of the team that did it? Thanks :)Comfort3 Jul 31
Jul 27 Additional description of a mount Hi, where do i found the "special description" of a mount. For example, this one: http://www.wowhead.com/item=19902/swift-zulian-tiger "The last known Zulian tigers were kept by High Priest Thekal, deep within Zul'Gurub. They are said to have been hunted into extinction." Legacy" I can´t find it in the item, spell or mount api.Treeman2 Jul 27
Jul 27 MMR in sc2 API ... source: https://www.reddit.com/r/starcraft/comments/4qgx24/hi_rstarcraft_were_going_to_be_hosting_a_ladder/d51n0vw 24+ days are passed from the day of that post. Are there any updates? When we can expect to see MMR in sc2 API? EDIT (Aurifex): Replaced short URL link with the real link.madness15 Jul 27
Jul 26 API or RSS for forums Hello guys! Is there anything that I can do to get some kind of notification, for selected topics (or for topic that I created or joined) in Blizzard's forums? My apologies if this was already discussed here other time.Josi10 Jul 26
Jul 26 Releasing a D3 app, API Key Question Hi, Just a quick question. I'm creating a Diablo 3 App that uses the community APIS. It says strictly that the Key should not be shown to users (I assume this means including it in config files too that are going to be bundled into the APK). Does this mean that anyone who wants to use the app, needs to make a Mashery account and create a API key, or is there something i'm missing? (The Apis i'm talking about are the D3 Community Apis) Thanks in advance! Edit: ... I did look in the FAQ, but this seems to slightly conflict with whats int he API documentation, so i wanted to be sure. From this i understand i can use the API key/store it in a config file and use it to make requests on the released application.Azer2496 Jul 26
Jul 25 Newsfeed data As we know, battle.net had implemented RSS channels with latest articles on website for every game (like in d3: http://eu.battle.net/d3/en/feed/news ) Well.. had. New website of Overwatch don't have this function (or it is well hidden), posibly becouse of website domain change and all links structure. The same thing apply to World of Warcraft website - there is no RSS channel on new domain, but in this case RSS still works on previous link ( http://eu.battle.net/wow/en/feed/news ) So my question is: Can we expect some day to refill this holes in our magnificent notification systems? ;) With RSS channels, or maybe integrated with API? It would be awsome to have a chance to download newsfeed by it.Eridor16 Jul 25
Jul 25 OAuth API returning blank battle tag? What would be the cause of this? I'm using the OAuth endpoints, and yet I'm getting a blank battletag when the user authorizes our application. Notably a user ID is returned in the response, just the battletag is missing ( I can supply the user ID if needed, but left it out)... https://us.api.battle.net/account/user?access_token=token {"id":xxx,"battletag":null} The user says he just registered the account recently, so not sure if that has something to do with it. Also have had hundreds of other users sign up with no issues, so far this has only happened with this particular user. EDIT: It seems he didn't set a battle tag yet on his account. I didn't realize that was optional.x3sphere0 Jul 25
Jul 25 PHP Lua Parser Does anyone know how I could parse a LUA file into a PHP Array? I have one and it does work mostly, but not for all LUA files. For example if the LUA is like example 1 it will work, if however it is like example 2, it doesn't. Example 1 data={ {0,"Some data",19,"Some other data",12,1,2,5042,2047,0,0}, {0,"Some data",19,"Some other data",12,1,2,5042,2047,0,0}, } Example 2 data={ ["Zone"] = { ["Node"] = { { 0.071000000000000, 0.399000000000000, 0, false, [181556] = { 0, 0, }, }, { 0.081000000000000, 0.499000000000000, 0, false, [181556] = { 0, 0, }, [181557] = { 0, 0, }, }, }, }, } The code that I am using is the one here : hxxps://github.com/KeldorDE/Lightweight-PHP-LUA-Parser/blob/master/parser.php I've attempted to fix that one but my fix didn't work as intended.AeroMaxx4 Jul 25
Jul 25 Oauth Login localhost can we test the oauth login on localhost ? (since https is required) ?Madmartigan3 Jul 25
Jul 25 Roadmap for apis? The major browsers do this now, and I find it very cathartic to see the features they are looking at and working on. Especially when i'm waiting on something. At this point i'm still hoping for the OW apis before my kids are old enough to build the stats reporting site with me. but it would be nice to have a roadmap to see whats being worked on and what on deck and what features are further out in the future. This way at the very least i can stop waiting on pins and needles for something that might be years away. Thanks!MooCow0 Jul 25
Jul 25 Cloud9 Host, oauth errors using django-allauth Hello, I've been using django-allauth and the blizzard oauth2 functionality from pythonanywhere (django-based site) without issue for some time. I'm wanting to switch to c9 as they appear to give you ssl access without a paid subscription and since this is dev I just want to do my testing and push to prod. On python anywhere the same code works just fine, but when I cloned my code on c9, created a new application on the dev.battle.net site and put the new key and secret into my project on c9 I get authentication errors. Specifically, {'provider': 'battlenet', 'exception': OAuth2Error('Error retrieving access token: b\'{"error":"invalid_request","error_description":"Internal server error"}\'',), 'code': 'unknown'} I can't seem to get any more detail than that. Has anyone tried to use this service before (cloud9) with blizzard oauth2 and made it work?Kalinakov0 Jul 25
Jul 25 WoW Prestige How to get Prestige and Honor levels? I think that there is some way to get them because they are displayed on the Web site and official Armory app, but I can't find request in the API.Diavol6 Jul 25
Jul 25 World of Warcraft Appearances data from API How can I get my appearances data from the blizzard api? I can't seem to see an obvious endpoint for this in the api docs. But the guys over at wowhead are getting this data somehow? and quickly too! hxxp://www.wowhead.com/wardrobe Any help is very much appreciated.AeroMaxx4 Jul 25
Jul 25 Taiwan Region Account Lookup Failures Hi there, I was trying to help diagnose an OAuth problem with a user from Taiwan, but I am getting repeated 500s when calling tw.api.battle.net. Here's an example request/response: $ curl -v 'https://tw.api.battle.net/wow/user/characters?access_token=...&locale=en_US' * Trying 50.16.189.212... * TCP_NODELAY set * Connected to tw.api.battle.net (50.16.189.212) port 443 (#0) * TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 * Server certificate: api.battle.net * Server certificate: DigiCert SHA2 Extended Validation Server CA * Server certificate: DigiCert High Assurance EV Root CA > GET /wow/user/characters?access_token=...&locale=en_US HTTP/1.1 > Host: tw.api.battle.net > User-Agent: curl/7.51.0 > Accept: */* Response: < HTTP/1.1 500 Internal Server Error < Date: Sat, 22 Jul 2017 05:19:27 GMT < Retry-After: 600 < Server: Apache < X-Frame-Options: SAMEORIGIN < X-Mashery-Responder: prod-j-worker-us-east-1e-127.mashery.com < X-Plan-QPS-Allotted: 100 < X-Plan-QPS-Current: 1 < X-Plan-Quota-Allotted: 36000 < X-Plan-Quota-Current: 13 < X-Plan-Quota-Reset: Saturday, July 22, 2017 6:00:00 AM GMT < transfer-encoding: chunked < Connection: keep-alive < {"status":"nok", "reason": "Have you not been through enough? Will you continue to fight what you cannot defeat? (something unexpected happened)"} If I make the same request against us/eu/kr, it works. The only problem is the user has no characters on those regions, so it doesn't help them with what they are trying to do (link characters to their account). Anyone know a workaround I can take use for now?Comfort2 Jul 25
Jul 25 Overwatch API Launch Notification? Is there a mailing list or something similar I can get on so that I may be immediately notified as soon as this is available?Orion0 Jul 25
Jul 21 LCD info API for WoW? The Logitech gaming software can directly pull certain data from the WoW client to display on the LCD of the G15 keyboard and the Android app for its newer keyboards. I think some other peripheral vendors can access this data in the same way. Is this that API? I always thought this was the API for web-based applications. Can I use this stuff to make a Windows program to display the same stats like I can see on my G15 keyboard in realtime, possibly to an Arduino-controlled LCD while I'm playing WoW?Cedric3 Jul 21
Jul 20 Overwatch APi Why is an API link on Overwatch site if there is NO overwatch API avaliable?Frost0 Jul 20