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

  • ... 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
    • Just to note, this service isn't quite ready for prime time, we're experimenting a bit with this service: but we did make this with the intent of making everyone's lives a bit easier (including ours!) So just as a heads up, the results you get from this call are still subject to change for a bit. I'll give you a heads up here in advance if there ends up being changes that will come through and break the contract.

      Posting in language:

       

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

      1 Reply
      • Edited by lowlines: 8/19/2015 2:50:12 PM
        *Moved into the topic post*

        Posting in language:

         

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

      • Wooow this is awesome, now i can refactor my code and remove all those nested network calls with a lot of failure paths :) This, should make my code cleaner and reduce the times i need to hit the cloud.

        Posting in language:

         

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

        13 Replies
        • Edited by Bunk3r: 8/19/2015 6:25:32 AM
          * DELETED *

          Posting in language:

           

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

        • you are awesome, thank you for all of the documentation you do :)

          Posting in language:

           

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

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