Skip to content

Latest commit

 

History

History
55 lines (43 loc) · 3.43 KB

Using the Data Sets API.md

File metadata and controls

55 lines (43 loc) · 3.43 KB

1 - Finding Membership ID and Membership Type

Most Bungie.net API calls require both Membership ID and Membership Type. Here's how to get them.

  1. Head over to the amazing Destiny Sets API site.
  2. You'll be prompted to auth with Bungie.
  3. After authenticating, press "Send" and you'll see something like the following. You might have to click on the diamond next to destinyMemberships to see your memberships, and you may have several memberships. If you have more than one, choose the one that's the most obviously active one.

CleanShot 2024-01-17 at 16 48 10@2x

2 - Finding Character IDs (OPTIONAL)

Some API calls also require a Character ID, which you can think of as uniquely identifying one of the maximum of three Guardians you can create. Now that you have your Membership ID and Membership Type, we can find our character IDs.

  1. Head over to the /GetProfile endpoint page. Notice that "Characters" appears in the "components" section. This is the information that you're requesting about your profile.
  2. Fill in the Membership ID and Membership Type.
  3. Ensure the "OAuth access_token" checkbox is checked.
  4. Press "Send".
  5. You'll see something like the following, which contains all of your per-character information.

CleanShot 2024-01-17 at 16 59 03@2x

3 - Collecting Vault Zero Data

If we're debugging something together, I might ask for you to provide data that Vault Zero requests from Bungie on your behalf. Here is everything Vault Zero requests:

let components = [
    102, // ProfileInventories    (Items in vault)
    200, // Characters            (Per-character data; last played, light level, etc.)
    201, // CharacterInventories  (Items on character; not equipped)
    202, // CharacterProgressions (Faction, experience, etc. "levels") relevant to each character
    204, // CharacterActivities
    205, // CharacterEquipment    (Items on character; equipped)
    300, // ItemInstances         (Light, damage type, etc.)
    301, // ItemObjectives        (For items that have objectives bound to them)
    305, // ItemSockets
    309, // ItemPlugObjectives
    900, // Records               (Status of Triumphs, Patterns, Lore, ...)
   1000, // Transitory            (Fireteam, current activity, ...)
   1200, // StringVariables       (Values substituted in to modifier text, etc.)
]
  1. Head over to the /GetProfile endpoint page again, but you want to use this link, which has pre-filled all the above components.
  2. Fill in the Membership ID and Membership Type.
  3. Ensure the "OAuth access_token" checkbox is checked.
  4. Open the Web Inspector (View > Developer > Developer Tools).
  5. Click on the "Network" tab.
  6. Back on the website now, press "Send".
  7. The request will be submitted and you'll see something like {crazy long number}/components in the list of requests.
  8. Right-click on that line, and save the HAR file, as shown below.
  9. Send it on over!

CleanShot 2024-01-17 at 17 45 08@2x