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
5d [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: <Gym85 5d
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
May 7 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) Aurifex83 May 7
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
Sep 7 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!Sapu14 Sep 7
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
22m Auction API Down As we have come to expect after patches, Blizzard's auction API is completely down for all realms since the patch. I hope it'll be fixed soon. https://does.theapi.work/ https://www.tradeskillmaster.com/wow-apiSapu2 22m
4h Undefined variable: q [php] Hi, question is open :( I have the same problem ...GulDan0 4h
7h Diablo 3 Leaderboard APIs Now Available! Throm-Ka Developer Community! I wanted to inform you that we have added new APIs, to support Diablo 3 Leaderboards, into our Mashery Cloud. These APIs are only available on the new *.api.battle.net hostnames (including China’s api.battlenet.com.cn host). In our API documentation you will find these endpoints listed under “Game Data APIs" and “Community OAuth APIs” (for China). Additionally, these APIs require OAuth client access tokens. A full user access token also works but you do NOT need to go through the full OAuth flow for this, a client token is enough. For more information you can take a look at the OAuth 2.0 spec (https://tools.ietf.org/html/rfc6749) or this helpful blog post: http://alexbilbie.com/2013/02/a-guide-to-oauth-2-grants/ The new APIs consist of six total endpoints – three for seasonal leaderboards and three for non-seasonal (era) leaderboards. Within each group there is one API to get data about the available seasons/era and the current season/era. One endpoint gives you a list of leaderboards for a particular season or era, and then the final endpoint gives you leaderboard data. Finally, these APIs consist of the exact data that we use internally to render the leaderboard data on the official Diablo 3 website. They are constructed in a way that includes the columns in each leaderboard so we can support data changing and manipulation without having to change the website code or UI layout. Due to this, these APIs are slightly more verbose than they would normally be otherwise. Please take a look at the APIs and let us know if you have any questions, we’re more than happy to help answer anything we can. Lok’Tar O’gar! -AndanionAndanion21 7h
22h WoW API Updates for Pre-Patch Greetings! The following are some of the changes being released for the WoW API with Pre-Patch: Professions on a character profile will display each expansion level: { "id": 2507, "name": "Kul Tiran Inscription", "icon": "inv_inscription_tradeskill01", "rank": 1, "max": 150, "recipes": [] }, { "id": 2508, "name": "Legion Inscription", "icon": "inv_inscription_tradeskill01", "rank": 1, "max": 100, "recipes": [] } Heart of Azeroth and Azerite Empowered Items will be available at the /items endpoint Within Azerite Empowered Items, there is a new field: azeriteClassPowers. This is a map of IDs for each class that can wear the item, and each ID contains a list of Azerite Class Powers that could be unlocked on the item. "azeriteClassPowers": { "1": [ { "id": 483, "tier": 3, "spellId": 280555, "bonusListId": 0 }, { "id": 434, "tier": 3, "spellId": 278751, "bonusListId": 0 }, Please let us know if you encounter any issues. Thanks!Ladd1 22h
1d PvP Selected Talents I'm not seeing where the PvP talents are. I do see a bunch of empty talent slots, however, those appear to be for extra specializations. If you look at my character: Cryptstone - Dalaran - us, you can see that while I do have PvP talents selected in-game but they are not showing up in the API data.Stone0 1d
1d 30% of M+ characters named "Unknown" since 8.x Hi there, The Mythic+ Game Data APIs are often returning character names as "Unknown" right now. A look at the top 20 runs on raider.io is showing ~30% of the characters as "Unknown". You can also see the same problem on the official web leaderboards, though I think the quantity may be slightly less. When this problem occurs we've noticed that both the name and faction tend to be wrong in the data (the faction is set to "NONE"). I've talked to a few players who have had this problem and there was no recent server/faction transfer, rename, or anything of that sort. From what I can tell this is not consistently happening even for affected characters. It just seems that sometimes their information isn't registered properly in the API and comes through as "Unknown". If it would help to get some specific characters I can provide it over a private message. Thank you :) Note: I'd posted a thread like this yesterday, but I'm assuming it was removed because I linked a specific group where this problem occurred. So I've avoided providing any specific details here. If you just visit raider.io though you can see the issue very prominently on our Mythic+ leaderboards.Comfort0 1d
1d Battle for Azeroth Dungeon/Raid stats - summaries missing Hello, I see that there are entries for individual boss kills for Battle for Azeroth in the statistics, however, I do not see an entry for a summarized stat like there is for Lich King, Cata, Mists, Warlords, and Legion. When I pull in the statistics data, specifically: statistics > subCategories > 5 > statistics > 32 > quantity This holds the number of Legion raid bosses killed. This particular stat only goes to 34 which is Challenge mode dungeons completed. I was hoping there would be two entries for BFA dungeon bosses killed and BFA raid bosses killed instead of requiring us to add up all the individual boss kills on every difficulty. Is this something that was intentionally left out or was it planned for addition later once the content unlocks?Stone0 1d
1d Hearthstone player profiles Dear API developers, As this game is 1.5 years old now, isn't it the time to open possibility to create some nice community websites with player profiles data, like seasonal rankings? P.S. I'm developing https://www.heroprogress.com - Hearthstone rankings database.Kernel41 1d
1d Quest completion timestamp Is there a way to figure out when was a quest completed by a specific character?Witoruis0 1d
1d 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.Whisperer61 1d
2d Can I get character bank information using the API? Hi all! Like some, I am highly anticipating the recently announced World of Warcraft classic and am playing around with addon creation in preparation for this. Now yes, I know that we haven't been given any news in regards to what API version Blizz might use for Classic, but I was at least hoping to get something working on retail in preparation. So with that in mind, here is what I'm trying to achieve. I am looking to get say, the ID of all items within my characters bank and the total gold stored. I would then, use this information to create a shared bank view for anyone else with this addon installed. I'm not looking for any interaction with the bank, just a view. The reason for this, is that I'm assuming on the realise of classic, Blizz will not be implementing the guild bank. So, I'm just testing the water to see what could be achieved using the addon API. Thanks!classicaddon2 2d
2d WoW Community API 8.0 Hi, just wondering when the community API will be updated for 8.0, or if any documentation/info will be available soon for the new data for BfA (Necklace, Azerite gear etc) so I can ensure my apps are updated and working! Thanks.Shawry0 2d
2d PvP API Not updating consistently - Lots of periods of inactivity + some players not updating For the past 2 days, the PvP API has been performing very poorly, with very few players getting updated on a regular basis For both EU/US, the API had been performing well this season until now - Can this be looked into? Thanks!searay7 2d
Jul 10 ERROR: invalid_request, DESCRIPTION: Internal server error Hi Guys, Currently I have a problem about testing Oauth 2.0. if a web server send a packet to battle.net, &response_type=code&state=<state_value>&scope=sc2.profile&redirect_uri=http%3A%2F%2Fkr.sc2.domain.com%2Fpc%2Fcallback.php" class="bml-link-public">https://kr.battle.net/oauth/authorize?client_id=<client_id_value>&response_type=code&state=<state_value>&scope=sc2.profile&redirect_uri=http%3A%2F%2Fkr.sc2.domain.com%2Fpc%2Fcallback.php then the web server received a packet from battle.net. http://kr.sc2.domain.com/pc/callback.php?error=invalid_request&error_description=Internal%20server%20error&state=6a37f2a08fbee6fa also, I can see same error message on web browser. Can you give me an advice ? Let me know if you have any question. Best Regards,XSUN4 Jul 10
Jul 10 Explanation of WOW advanced combat logging? I'm digging into wow combat log files and I found this https://wow.gamepedia.com/COMBAT_LOG_EVENT as a documantation about all the different events, but I couldn't find anything about all the additional fields added by advanced combat logging. For example for the SPELL_HEAL event I have the following fields 1 type SpellHealAdvanced struct { 2 UUID string `json:"uuid"` 3 TimeStamp string `json:"timestamp"` //6/30 21:46:57.014 4 EventType string //SPELL_HEAL 5 CasterID string //Player-970-000BF9AC 6 CasterName string //"Eluxbeta-Sylvanas" 7 CasterType string //0x511 its always 511 for me and 512 for other grp members and other stuff for enemy trash 8 SourceFlag string //0x0 9 TargetID string //Player-970-000BF9AC 10 TargetName string //"Eluxbeta-Sylvanas" 11 TargetType string //0x511 12 DestFlag string //0x0 13 SpellID int //194509 14 SpellName string //"Power Word: Radiance" 15 SpellType string //0x2 //holy i guess 16 AnotherPlayerID string //Player-970-000BF9AC 17 D0 string //0000000000000000 18 D1 string //89449 19 D2 string //93932 20 D3 string //5637 21 D4 string //998 22 D5 string //2599 23 D6 string //1 24 D7 string //596 25 D8 string //1000 26 D9 string //0 27 D10 string //-967.46 coordinates? 28 D11 string //2171.14 ^ 29 D12 string //0.4005 ^ 30 D13 string //313 31 D14 string //5101 32 Amount string //5101 33 Overhealing string //0 34 Absorbed string //0 35 Critical string //nil 1 = crit, nil = noncrit 36 } does advanced combat logging add completely new events? In another log I saw something like COMBATANT_INFO, I didn't check if it also exist in normal logs any help is greatly appreciatedElux1 Jul 10
Jul 10 Can I use Unit/Building images in my app I want to build an app to teach players about different statistics of the different units and and buildings in StarCraft. Is it legal for me to use the images from the games (while mentioning image copyrights belong to Blizzard)?Aero0 Jul 10
Jul 8 The 2018 "Can we have a toy API please?" thread As above, could we have a toy API please? <3cuddlywookie0 Jul 8
Jul 8 WoW - Incomplete Character's Title List from EU API I've used the link below to bring back a list of a players titles. He's confirmed that the PvE titles are there, but most, if not all PvP titles are missing. https://eu.api.battle.net/wow/character/dragonblight/Casval?fields=titles&locale=en_GB&apikey= Is this a bug or an expected result? I've confirmed with them that the following titles are visible on the Character Casval in game. "it's missing Lord of War, all the Nemesis ones (Gnomebane, Draenei Distroyer etc), the Prestigious, Spear of Vol'Jin (pvp rep), and even Warlord of Draenor (garrison building pvp achi) and Patron of War." - Many Thankscuddlywookie5 Jul 8
Jul 8 API feature request: displayID for pets I requested this many years ago and since a few things are being updated in the WoW API lately I wanted to submit an updated request, if it's ok: Could we please have the displayID included in WoW API returns for player collections of both battle (companion/mini) pets and Hunter pets? In both these cases, the pet can occur in multiple colours / sizes, but the current data structure leaves no way of determining which the player has. If the displayID is given then we can easily develop a way of displaying this. This would greatly help out any site that displays pet collections. As an example, the Stormwind Rat (battle pet) occurs in three colours. The in-game pet journal displays the correct colour depending on which a player has captured, but to a third party site / app / even your official Armory there's no way of telling which colour each is, since they all have exactly the same creatureID. So they're just as likely to be displayed in the wrong colour. Many thanks :)Wain1 Jul 8
Jul 8 Icons are missing Hey there, I recently started with the API but some icons are not working. Im using this URL: https://blzmedia-a.akamaihd.net/wow/icons/56/ For example this icon is not found: https://blzmedia-a.akamaihd.net/wow/icons/56/inv_hordezeppelinmount.jpg Any ideas how to fix this?Smythu8 Jul 8
Jul 8 Send to guild chat character levels for dungeons Hello everyone, I'm completely new to scripting for WoW and I'm trying to create a small script, but I have no clue how to continue. After a long search I don't know how to find what I need. What I want is to send some chat to my guild with all the levels of my available characters to play dungeons. Something like this: ... So I managed to send text and ended up with something similar to this: /script SendChatMessage("Prot war lvl "..UnitLevel("Charone-Server")..", Prot war lvl "..UnitLevel("Chartwo-Server")..", Blood DK lvl "..UnitLevel("Charthree-Server").." ready for random dungeon", "GUILD"); But when I execute the script I get the following result: ... The API clearly doesn't understand it if I just write the character name, it understands "player" or "target" or things like that. I understand it needs an ID, so I created another script like this: /script SendChatMessage(UnitGUID("player")); That returned something like "Player-5614-81AB556F". I tried to use that ID in my previous script but it still returns a 0, even with the same character I got that ID. It must be so easy and simple to do it, but I just have no idea how to continue or how to keep on searching. Please help. Thank you for your time. Regards, DavidDaMMit0 Jul 8
Jul 8 Hiring a developer for Mythic Dungeon Leaderboard API Project Hello! I'm looking for a developer that can help with bringing a project to reality. The project will be utilizing the Blizzard API to pull various information from characters, guild, and mythic dungeon leaderboards (similarly to sites like Raider.io and WoWProgress). This site won't need a fancy frontend as this site will just be used for research purposes. If this is something you are interested in, please send me an email at bordot [AT] gmail [DOT] com. Please include your experience with the API and your future availability. Thanks!Arbaxas0 Jul 8
Jul 7 Overwatch General Stat API | Still nothing? It's been almost over 1-and-a-half year that we've last heard something regarding a Overwatch General Stat API, and we still don't have any stance to it. Especially with the recent Private Profile option, a lot of scrapper sites that have served as substitute have become severely compromised, and (worst case) distribute outdated data from the last public read. We already have a API just for the OWL, and the Playoverwatch profiles show that the stats can be pulled in a yiffy, so why are there still no comments at all about it?Vatuu0 Jul 7
Jul 2 Race changes not updated in API Characters that have race changed are not reflecting their new race in the API. For example, Arisis-Illidan (US) returns Blood Elf from the API. But in game and on the Blizzard website, she is correctly shown as Nightborne.Kula2 Jul 2
Jul 2 Documentation for OWL api? I ran across this the other day, api.overwatchleague.com. Is this something we have documentation for? I'm able to figure out a few endpoints on my own.oneHP19 Jul 2
Jul 2 Battle.Net OAuth TLS Issue Hello, As of 6/21/2018, my web application has been failing when trying to reach this API URL after a user has logged in with OAuth: https://us.api.battle.net/account/user/battletag My error details: System.Net.WebException: The underlying connection was closed: An unexpected error occurred on a send. ---> System.IO.IOException: Authentication failed because the remote party has closed the transport stream. at System.Net.Security.SslState.StartReadFrame I believe this is related to a change in TLS or cipher requirements. Has your API's TLS requirements changed this week? Do you know of any other change that might have happened on that day?Benthor6 Jul 2
Jul 2 [WoW][Request] Guild Progression Just like you can request "character progression" you should be able to request "guild progression". I don't know why this is not a thing. I personally think this is a great feature and should definitely be added. Not only is it a great feature it will significantly reduce the amount of requests needed to figure out accurate guild progression(timestamps etc. which guild did it the fastest etc.). I and other devs interested in guild progression would no longer have to request all the characters in a guild individually to figure out boss kill timestamps. What I and sites like wowprogress do right now(it's a pain) : request a guild request each character from that guild (fields needed: achievements, feed, progression) grab best timestamp for either mythic achievements(only chars have mythic achievements per boss, guilds don't, which complicates things even more) or grab timestamp from news feed from guild characters compare that timestamp against guildies repeat till you find whatever you deem enough to call it a guild group assume that the timestamp was their first kill etc. etc. Please make our lives easier. If you add this field(you really should!) "guild progression" should return: which bosses got killed per raid per difficulty at least include the first kill timestamp, maybe other kill timestamps too? characters that were in the group(similar to how "guild challenge" returns who was in the group) time it took to kill a boss(don't know if this info is available) The most important information would of course be which bosses got killed on which difficulty and when(first kill timestamp being most important). If there's one feature that I wanna see in the API it is this one. Please consider this. I will love you forever. This will prevent many headaches for all of the developers out there that wanna do something cool with guild progression. TLDR: What we want: request guild progression in a single request. This will return an array of all raids and bosses containing the first and last kill timestamp for each boss per difficulty.vamp24 Jul 2
Jul 2 BfA races coming from the API? Hey - just made a query of the API for "Ryethe" on Sargeras, and the race came back "Highmountain Tauren". Should I be getting PTR races using the normal API or is there a switch I can set to only get "live" realms?Velvetine2 Jul 2
Jul 2 Voice Chat in WoW Are there are plans to add integrated voice chat in Battle for Azeroth? If so, will there be an API on the VC for addon developers to mess with? Things like Mute(player) Volume(player, -15) Play(filename.mp3) Thanks!Sunny1 Jul 2
Jul 1 Wowhead's item tooltip not working with JS Hey, everyone. Today I found out about Wowhead's tooltip and tried to implement some quick examples to my website for a quick test. <div id="container"> <a href="//www.wowhead.com/item=25697"></a> </div> <script>var whTooltips = {colorLinks: true, iconizeLinks: true, renameLinks: true, iconSize: 'medium'};</script> <script src="//www.wowhead.com/widgets/power.js" type="text/javascript"></script> The code above works perfectly, the tooltip is shown, the text has the correct quiality colors and so on. My Problem is that, when I use the WoW's FEED API and use the itemId for for the item nummer and output it to my HTML, the item is not shown. I made a quick example of the Item Tooltip not working with a simpler code. Here's my Codepen demo: https://codepen.io/GabrielvP/pen/MXLQoRExtremus2 Jul 1
Jul 1 [PHP] Crypto failed & Unkown SSL protocol error to eu.api.battle.net Hello, Since yesterday, my website get errors on every API calls. Maybe it's not related to it but maybe people can help => Warning: file_get_contents(): Failed to enable crypto Then i get this one https://eu.api.battle.net/wow/character/Khaz-Modan/Daerie?fields=items&locale=fr_FR&apikey=XXXXXX failed to open stream: But if i copy the URL in my browser i get the Json array... I did not change anything since a few weeks so... that's odd EDIT : i just tried curling it and i get this : Unknown SSL protocol error in connection to eu.api.battle.net:443Rude9 Jul 1
Jun 29 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.CrazyJabber14 Jun 29
Jun 28 bug hallo ich wurde gerne ein ticket schreiben aber ich komme nicht auf die seite kann mir jemand die seite schicken falls ja bedanke ich mich schon mal im voraus.blackkat0 Jun 28
Jun 28 API to find characters that starts with "userinput..." Which API is necessary to get all characters on any realm whose name starts with a text enterted by the user? This is for autocomplete purposes i don't requiere all details, just the name and realm.WesosDQueso2 Jun 28
Jun 28 Use Character API data to create image I would like to have portraits on my guild's "roster" page that are updated via API. I can get character info data and everything but I don't exactly know what to do with it to get the portrait result. I'm new to API's and willing to use any languages but prefer js if possible. Any tips?Wyther4 Jun 28
Jun 27 [Request] Auction House API Documentation Hey Blizzard, After having looked a bit into the Auction House API and many of the great community posts and contributions I think it would be about time to get some official documentation along with tools to help us work with the API it self. I am more specifically talking about not only what the following is but also a way to get a list of all the possibilities for each. A suggestion could be to call an API and obtain a list of all of the following: "rand" "seed" "context" "bonuslistID" and "Modifiers (type / values)" etc. As of right now I still have no clue my self as of what "modifiers" are. Some current great community posts could be: https://wow.gamepedia.com/ItemRandomSuffix https://github.com/simulationcraft/simc/blob/legion-dev/SpellDataDump/bonus_ids.txt But only god knows how long they will be around yet alone updated, it would be great if we could have some nice documentation from Blizzard self along with tools to get a list of the various BonusIDs / Rand etc. A little side question as well, is it possible to see if an item has been enchanted by a player or could it be possible for the future :)? Best regards Shamatix. EDIT: It's of course the Auction API I am speaking of, example of a return value from the Auction API could be: {"auc":280745399,"item":1482,"owner":"Swaguna","ownerRealm":"Blackhand","bid":1187495250,"buyout":1249995000,"quantity":1,"timeLeft":"VERY_LONG","rand":0,"seed":0,"context":1,"bonusLists":[{"bonusListId":4049}],"modifiers":[{"type":9,"value":60}]}Shamatix0 Jun 27
Jun 25 How to get portrait of character How to get portrait of character?RoboMagik5 Jun 25
Jun 24 About the key rate limits Hey folks ! I'm developping my app and I want to get informations about characters as often as possible for making statistics over the time. So I'll have to execute as much api call as I can. If my app meet a certain success I think the 36000 api call per hour limit can be a problem. Do you guys know if it is possible to extend this limit ? Or if it is allowed to create other apps to use multiple api keys ? Thank you in advance :)Kilnih4 Jun 24
Jun 23 Connection timed out Hello ! I regularly have a "Connection timed out " and I do not understand where it comes from. My little app worked perfectly until a few days ago. Did anyone else have the problem? Sorry if my english is not very good ^^"Zephiral2 Jun 23
Jun 22 WoW race icons WoW Data Resouces / Character Races API has no icons (male and female), so i'm trying to use what i find. I can find pretty much all legacy races easily using wowhead' Icons tool: http://www.wowhead.com/icons/name:male For instance: https://render-eu.worldofwarcraft.com/icons/56/race_goblin_male.jpg https://render-eu.worldofwarcraft.com/icons/56/race_goblin_female.jpg The problems start arise with male Pandaren (no icon) and new (allied) races (Void Elf, etc). On the internet, i have found following image: https://media.mmo-champion.com/images/news/2017/november/CharacterCreateIcons.jpg These icons has new look and seems like taken from the game. Does anyone know how can i get names of those icons?Lexx1 Jun 22
Jun 20 Thumbnail prefix? What is the prefix for EU thumbnails? When for instance fetching guild members each member character has an avatar thumbnail e.g. "blackmoore/132/132537732-avatar.jpg" What is the URL prefix to load/display those thumbnails? And more questions, { "character": { "name": "Rigormortiss", "realm": "Blackmoore", "battlegroup": "Glutsturm / Emberstorm", "class": 3, "race": 2, "gender": 0, "level": 7, "achievementPoints": 0, "thumbnail": "blackmoore/132/132537732-avatar.jpg", "guild": "Funky Fires", "guildRealm": "Blackmoore", "lastModified": 0 } Where do I get the numbers mapping from? class 3, race 2, gender 0 Is there a table or resource I could query?Darq12 Jun 20