UNPKG

bungie-net-core

Version:

An easy way to interact with the Bungie.net API

249 lines (248 loc) 10.6 kB
/** * Bungie.Net API * These endpoints constitute the functionality exposed by Bungie.net, both for more traditional website functionality and for connectivity to Bungie video games and their related functionality. * * Contact: support@bungie.com * * NOTE: This class is auto generated by the bungie-net-core code generator program * Repository: {@link https://github.com/owens1127/bungie-net-core} * Do not edit these files manually. */ /** * Represents the possible components that can be returned from Destiny "Get" calls * such as GetProfile, GetCharacter, GetVendor etc... * * When making one of these requests, you will pass one or more of these components * as a comma separated list in the "?components=" querystring parameter. For * instance, if you want baseline Profile data, Character Data, and character * progressions, you would pass "?components=Profiles,Characters, * CharacterProgressions" You may use either the numerical or string values. * @see {@link https://bungie-net.github.io/#/components/schemas/Destiny.DestinyComponentType} */ export type DestinyComponentType = 'None' | 0 /** * Profiles is the most basic component, only relevant when calling GetProfile. * This returns basic information about the profile, which is almost nothing: a * list of characterIds, some information about the last time you logged in, and * that most sobering statistic: how long you've played. */ | 'Profiles' | 100 /** * Only applicable for GetProfile, this will return information about receipts for * refundable vendor items. */ | 'VendorReceipts' | 101 /** * Asking for this will get you the profile-level inventories, such as your Vault * buckets (yeah, the Vault is really inventory buckets located on your Profile) */ | 'ProfileInventories' | 102 /** * This will get you a summary of items on your Profile that we consider to be " * currencies", such as Glimmer. I mean, if there's Glimmer in Destiny 2. I didn't * say there was Glimmer. */ | 'ProfileCurrencies' | 103 /** * This will get you any progression-related information that exists on a Profile- * wide level, across all characters. */ | 'ProfileProgression' | 104 /** * This will get you information about the silver that this profile has on every * platform on which it plays. * * You may only request this component for the logged in user's Profile, and will * not recieve it if you request it for another Profile. */ | 'PlatformSilver' | 105 /** This will get you summary info about each of the characters in the profile. */ | 'Characters' | 200 /** * This will get you information about any non-equipped items on the character or * character(s) in question, if you're allowed to see it. You have to either be * authenticated as that user, or that user must allow anonymous viewing of their * non-equipped items in Bungie.Net settings to actually get results. */ | 'CharacterInventories' | 201 /** * This will get you information about the progression (faction, experience, etc... * "levels") relevant to each character, if you are the currently authenticated * user or the user has elected to allow anonymous viewing of its progression info. */ | 'CharacterProgressions' | 202 /** * This will get you just enough information to be able to render the character in * 3D if you have written a 3D rendering library for Destiny Characters, or " * borrowed" ours. It's okay, I won't tell anyone if you're using it. I'm no snitch. * (actually, we don't care if you use it - go to town) */ | 'CharacterRenderData' | 203 /** * This will return info about activities that a user can see and gating on it, if * you are the currently authenticated user or the user has elected to allow * anonymous viewing of its progression info. Note that the data returned by this * can be unfortunately problematic and relatively unreliable in some cases. We'll * eventually work on making it more consistently reliable. */ | 'CharacterActivities' | 204 /** * This will return info about the equipped items on the character(s). Everyone can * see this. */ | 'CharacterEquipment' | 205 /** This will return info about the loadouts of the character(s). */ | 'CharacterLoadouts' | 206 /** * This will return basic info about instanced items - whether they can be equipped, * their tracked status, and some info commonly needed in many places (current * damage type, primary stat value, etc) */ | 'ItemInstances' | 300 /** * Items can have Objectives (DestinyObjectiveDefinition) bound to them. If they do, * this will return info for items that have such bound objectives. */ | 'ItemObjectives' | 301 /** * Items can have perks (DestinySandboxPerkDefinition). If they do, this will * return info for what perks are active on items. */ | 'ItemPerks' | 302 /** * If you just want to render the weapon, this is just enough info to do that * rendering. */ | 'ItemRenderData' | 303 /** * Items can have stats, like rate of fire. Asking for this component will return * requested item's stats if they have stats. */ | 'ItemStats' | 304 /** * Items can have sockets, where plugs can be inserted. Asking for this component * will return all info relevant to the sockets on items that have them. */ | 'ItemSockets' | 305 /** * Items can have talent grids, though that matters a lot less frequently than it * used to. Asking for this component will return all relevant info about activated * Nodes and Steps on this talent grid, like the good ol' days. */ | 'ItemTalentGrids' | 306 /** * Items that *aren't* instanced still have important information you need to know: * how much of it you have, the itemHash so you can look up their * DestinyInventoryItemDefinition, whether they're locked, etc... Both instanced * and non-instanced items will have these properties. You will get this * automatically with Inventory components - you only need to pass this when * calling GetItem on a specific item. */ | 'ItemCommonData' | 307 /** * Items that are "Plugs" can be inserted into sockets. This returns statuses about * those plugs and why they can/can't be inserted. I hear you giggling, there's * nothing funny about inserting plugs. Get your head out of the gutter and pay * attention! */ | 'ItemPlugStates' | 308 /** * Sometimes, plugs have objectives on them. This data can get really large, so we * split it into its own component. Please, don't grab it unless you need it. */ | 'ItemPlugObjectives' | 309 /** * Sometimes, designers create thousands of reusable plugs and suddenly your * response sizes are almost 3MB, and something has to give. * * Reusable Plugs were split off as their own component, away from ItemSockets, as * a result of the Plug changes in Shadowkeep that made plug data infeasibly large * for the most common use cases. * * Request this component if and only if you need to know what plugs *could* be * inserted into a socket, and need to know it before "drilling" into the details * of an item in your application (for instance, if you're doing some sort of * interesting sorting or aggregation based on available plugs. * * When you get this, you will also need to combine it with "Plug Sets" data if * you want a full picture of all of the available plugs: this component will only * return plugs that have state data that is per-item. See Plug Sets for available * plugs that have Character, Profile, or no state-specific restrictions. */ | 'ItemReusablePlugs' | 310 /** * When obtaining vendor information, this will return summary information about * the Vendor or Vendors being returned. */ | 'Vendors' | 400 /** * When obtaining vendor information, this will return information about the * categories of items provided by the Vendor. */ | 'VendorCategories' | 401 /** * When obtaining vendor information, this will return the information about items * being sold by the Vendor. */ | 'VendorSales' | 402 /** * Asking for this component will return you the account's Kiosk statuses: that is, * what items have been filled out/acquired. But only if you are the currently * authenticated user or the user has elected to allow anonymous viewing of its * progression info. */ | 'Kiosks' | 500 /** * A "shortcut" component that will give you all of the item hashes/quantities of * items that the requested character can use to determine if an action (purchasing, * socket insertion) has the required currency. (recall that all currencies are * just items, and that some vendor purchases require items that you might not * traditionally consider to be a "currency", like plugs/mods!) */ | 'CurrencyLookups' | 600 /** * Returns summary status information about all "Presentation Nodes". See * DestinyPresentationNodeDefinition for more details, but the gist is that these * are entities used by the game UI to bucket Collectibles and Records into a * hierarchy of categories. You may ask for and use this data if you want to * perform similar bucketing in your own UI: or you can skip it and roll your own. */ | 'PresentationNodes' | 700 /** * Returns summary status information about all "Collectibles". These are records * of what items you've discovered while playing Destiny, and some other basic * information. For detailed information, you will have to call a separate endpoint * devoted to the purpose. */ | 'Collectibles' | 800 /** * Returns summary status information about all "Records" (also known in the game * as "Triumphs". I know, it's confusing because there's also "Moments of Triumph" * that will themselves be represented as "Triumphs.") */ | 'Records' | 900 /** * Returns information that Bungie considers to be "Transitory": data that may * change too frequently or come from a non-authoritative source such that we don't * consider the data to be fully trustworthy, but that might prove useful for some * limited use cases. We can provide no guarantee of timeliness nor consistency for * this data: buyer beware with the Transitory component. */ | 'Transitory' | 1000 /** * Returns summary status information about all "Metrics" (also known in the game * as "Stat Trackers"). */ | 'Metrics' | 1100 /** * Returns a mapping of localized string variable hashes to values, on a per- * account or per-character basis. */ | 'StringVariables' | 1200 /** * Returns summary status information about all "Craftables" aka crafting recipe * items. */ | 'Craftables' | 1300 /** Returns score values for all commendations and commendation nodes. */ | 'SocialCommendations' | 1400;