Greetings all,
To get right to it, we’ve determined that the Character Collections Mount Summary API is currently working as is intended. To be more specific, the API reflects the same data presented in-game should a player inspect their own mounts collection with all filters turned off, or more precisely, with the “Collected” and “Unusable” boxes both checked.
Additionally, the is_useable flag intends to allow consumers further to filter the document data to only useable mounts, as if the “Unusable” box was unchecked in-game. We understand this is not immediately apparent, and again we apologize for the lack of communication, documentation, and added confusion surrounding the addition of the is_useable flag property.
When possible, our intent with Character specific documents is to represent the data directly as a player would consume it in-game, and any deviation from this strategy is likely unintended or undesired. It is not our intention for Character specific documents to expose data that would be considered ‘account-wide’ when that same data would not be presented to the player in-game. An example of a deviation here is Achievement data, where the player can choose to display their account-wide achievements at the character level.
To best allow the player agency over their account-wide data and who consumes it, we recommend consumers interested in account-wide data integrate with the Account Mounts Collection Summary API available via the Battlenet OAuth Code Authorization flow, which provides a full picture of the mounts collected for an authorized account.
We understand and sympathize with the complexities and challenges this introduces for some projects. We wholeheartedly apologize for the lack of preparation you were given, and our failure to communicate the changes ahead of time. We failed to keep you informed that the previously observed behavior was being changed.
We much appreciate everyone’s patience and involvement in this discussion. Please continue to report any challenges you experience with the WoW APIs so that we can continue to grow and improve upon them together.
– Maguthul