JavaScript is required to use Bungie.net

Group Avatar

BungieNetPlatform

"Updates, discussions, and documentation of the BungieNetPlatform API."

Request Join
originally posted in:BungieNetPlatform
Edited by lowlines: 8/22/2015 9:02:36 PM
6

New API: GetDestinyAccountSummary (Preview)

[b]IMPORTANT:[/b] This API is still in development and will not only change over to GetAllItemsSummary on the 8th September, and will see some structure changes as well. Please check out the [url=https://www.bungie.net/en/Clan/Post/39966/148170470/0/0]Official post [/url]about this for more information. Created the Wikia page. http://bungienetplatform.wikia.com/wiki/GetDestinyAccountSummary This looks to be a new endpoint to assist with inventory managers / explorers. It is PUBLIC meaning the user doesn't need to be logged in to use this endpoint and it returns a complete list of all your items across all your characters and the vault along with character summaries combining [url=http://bungienetplatform.wikia.com/wiki/GetAccount]GetAccount[/url], [url=http://bungienetplatform.wikia.com/wiki/GetCharacterInventory]GetCharacterInventory[/url] , and [url=http://bungienetplatform.wikia.com/wiki/GetVault]GetVault[/url] (the last 2 require the user to be logged in to get the full list of items) in a single request. Things to note: - each item has a characterIndex where -1 is the vault - itemInstances are slimmed down versions including only bare bones information; primary stat, damage type, quantity, lock state, transfer status and whether the grid is complete (which can still be a bit quirky at times) - this means you will have to do all the equip/transfer conditionals yourself and request the bucket information from the manifest - it also means if you want more information about a specific item instance, you will need to use [url=http://bungienetplatform.wikia.com/wiki/GetItemDetail]GetItemDetail[/url] - characterInstances also have current play session information (currentActivityHash, minutesPlayedThisSession), while I believe this has been around for a while, I've only just noticed it and this could not only be used to check your friends activities like you do in game, but you could probably use that to check when you can equip items on your active character. [edit] Also if you want to know whether an item is currently equipped, check the [b]transferStatus[/b] (thanks VlakatafakatA for pointing this out): 0 = Transferable 1 = Equipped 2 = Not Transferable 3 = Equipped & Not Transferable (this probably means transferStatus is a sequence of bit flags)

Posting in language:

 

Play nice. Take a minute to review our Code of Conduct before submitting your post. Cancel Edit Create Fireteam Post

View Entire Topic
  • ... and of course, there is a change. ;) Our next intended release in a couple of weeks will see this service renamed and the endpoint changed. GetDestinyAccountSummary [b]will become GetAllItemsSummary[/b], to better reflect the intent of the service and free up the name for a GetDestinyAccountSummary service that actually *will* be an account level summary service call. ;) The [b]endpoint will become {membershipType}/Account/{membershipId}/Items/[/b] instead of .../Summary/ The expected inputs and outputs aren't intending to be altered at this time, but just as a heads up. I'll make another reminder as we get closer to release, so you know when we're going to make the changeover.

    Posting in language:

     

    Play nice. Take a minute to review our Code of Conduct before submitting your post. Cancel Edit Create Fireteam Post

    11 Replies
    You are not allowed to view this content.
    ;
    preload icon
    preload icon
    preload icon