Launching inventory endpoints
Lawton Campbell.8517:
Activated a handful of new endpoints — mostly authenticated and require the “inventories” permission — that provide access to an account’s various inventories:
- /v2/materials - unauthenticated endpoint which provides localized names and contents for each of the material storage tabs. (CDI)
- /v2/account/bank - the contents of the account’s bank. (CDI)
- /v2/account/materials - the contents of the account’s material storage. (CDI)
- /v2/characters - will now contain equipment and inventory fields when the token has the “inventories” scope. (CDI)
- /v2/characters/:id/inventory - just the inventory data. (CDI)
- /v2/characters/:id/equipment - just the equipment. (CDI)
Note that, as with all authenticated endpoints you can pass the API key either via an “Authorization: Bearer $key” header, or with the access_token parameter. Details about each of the endpoints can be found in the CDI pull requests on Github (linked for each one).
Finally, there’s a bug in the API enumeration that incorrectly and unconditionally lists the characters inventory/equipment endpoints as disabled. We’ll look to fix that at some point in the future so it shows the status of those endpoints properly.
Questions/comments? Happy developing
Gilj.6304:
Wow, it’s finally here \o/!
tyvm for the hard work!
<3 <3 <3, Gilj.
Ludovicus.7980:
GW2 armory, here we go!
Lawton Campbell.8517:
GW2 armory, here we go!
I think the last bit we’re missing for the MVP is traits/skills 
darthmaim.6017:
This is awesome, thanks!
Edit: What is up with all those (mostly non existing) items in characters “equipment” without a “slot” (IDs 62,63,64,…)? Some of them seem to be old town clothing (ID 36370) and some old PvP weapons (have PvP Sigils as upgrade, (ID 5365 with upgrade 21207)).
AllIsVain.6409:
If I have a stat selected item, does the inventory API let me see what the selected stat is?
Lawton Campbell.8517:
If I have a stat selected item, does the inventory API let me see what the selected stat is?
Uhh, I completely forgot about that. For the 1-time stat selections it does — those are actually containers that just create the selected item. For legendary weapons which let you switch at-will, it won’t currently display which stats are selected. I’ll have that fixed at some point.
Completely forgot that was a thing.
Lawton Campbell.8517:
Edit: What is up with all those (mostly non existing) items in characters “equipment” without a “slot” (IDs 62,63,64,…)? Some of them seem to be old town clothing (ID 36370) and some old PvP weapons (have PvP Sigils as upgrade, (ID 5365 with upgrade 21207)).
O_o.
That’s a super weird bug, not sure how that slipped through the unit tests. Looking into it now.
rodadams.5963:
Much coolness.
I think we’ve just hit critical mass on data to make some truly cool tools.
I could see getting the wallet info out to complete some projects, such as checking Spirit Shard and gold count for questions like “Can I finish my Legendary with what I have right now?”
darthmaim.6017:
I admit, haven’t logged in with those characters for ages.
Faedrivin.5382:
I especially like the equipped stuff etc – now I can easily see all my characters’ stuff without having to rotate through them… I hope I find the time soon to code a little bit with it!
It’s great that this API is possible!
Lawton Campbell.8517:
I admit, haven’t logged in with those characters for ages.
Those broken equipment slots are on my linked examples (which are from my account) — after digging around in the code a bit, older characters still apparently have things equipped in clothing slots (whereas newer ones don’t). Super weird, but easy enough to fix.
Rashy.4165:
GW2 armory, here we go!
I think the last bit we’re missing for the MVP is traits/skills
Yes, please! Would be awesome to have easy access to skills/traits for build calculators.
Leg.7632:
It looks like the backpack and aquatic helm are missing the ‘skin’ field under character
{"equipment":
[{"id":64050,“slot”:“HelmAquatic”,upgrades,
{"id":62921,“slot”:"Backpack"},
{"id":6913,“slot”:“Coat”,skin,
Lawton Campbell.8517:
They’re not transmuted — they’re using the default skin of the item.
Vegeta.2563:
Is sharing API Keys with other players ok to do, or should I keep this information to myself? I wasn’t sure if say giving someone an API Key would put me at risk for account compromisation, or something related to that.
derzwo.3672:
woooooooow! just want coding – but first… get some sleep^^
(1:20 am in germany)
Lawton Campbell.8517:
Is sharing API Keys with other players ok to do, or should I keep this information to myself? I wasn’t sure if say giving someone an API Key would put me at risk for account compromisation, or something related to that.
API keys are meant to be shared — but try to make a different key for each application so that if you later change your mind you can revoke only the application you don’t want to use anymore. When you delete the key, you’re effectively retracting any access you granted by sharing them.
All of the links in the original post use an API key from my personal account, for example.
Using API keys does not increase your risk for account compromise.
Tamasan.6457:
Is sharing API Keys with other players ok to do, or should I keep this information to myself? I wasn’t sure if say giving someone an API Key would put me at risk for account compromisation, or something related to that.
Yes, it’s fine to share an API key with other people/websites. That’s actually the entire point of the API, to enable cool tools and such without risking account compromise. Data from the API is only read-only.
(In and of itself, sharing your API key does not increase your risk of account compromise. However, if for example you were to create an account at some website that lets you store your API key with them, do not under any circumstance reuse your game or email password.)
Lawton Campbell.8517:
I admit, haven’t logged in with those characters for ages.
Those broken equipment slots are on my linked examples (which are from my account) — after digging around in the code a bit, older characters still apparently have things equipped in clothing slots (whereas newer ones don’t). Super weird, but easy enough to fix.
Just deployed the fix for this.
Eight Samurai.6840:
Activated a handful of new endpoints — mostly authenticated and require the “inventories” permission — that provide access to an account’s various inventories:
- /v2/materials - unauthenticated endpoint which provides localized names and contents for each of the material storage tabs. (CDI)
- /v2/account/bank - the contents of the account’s bank. (CDI)
- /v2/account/materials - the contents of the account’s material storage. (CDI)
- /v2/characters - will now contain equipment and inventory fields when the token has the “inventories” scope. (CDI)
- /v2/characters/:id/inventory - just the inventory data. (CDI)
- /v2/characters/:id/equipment - just the equipment. (CDI)
Note that, as with all authenticated endpoints you can pass the API key either via an “Authorization: Bearer $key” header, or with the access_token parameter. Details about each of the endpoints can be found in the CDI pull requests on Github (linked for each one).
Finally, there’s a bug in the API enumeration that incorrectly and unconditionally lists the characters inventory/equipment endpoints as disabled. We’ll look to fix that at some point in the future so it shows the status of those endpoints properly.
Questions/comments? Happy developing
This stuff sounds really important…. but I don’t get it? What does all of this stuff mean?
Fatali.4819:
Activated a handful of new endpoints — mostly authenticated and require the “inventories” permission — that provide access to an account’s various inventories:
- /v2/materials - unauthenticated endpoint which provides localized names and contents for each of the material storage tabs. (CDI)
- /v2/account/bank - the contents of the account’s bank. (CDI)
- /v2/account/materials - the contents of the account’s material storage. (CDI)
- /v2/characters - will now contain equipment and inventory fields when the token has the “inventories” scope. (CDI)
- /v2/characters/:id/inventory - just the inventory data. (CDI)
- /v2/characters/:id/equipment - just the equipment. (CDI)
Note that, as with all authenticated endpoints you can pass the API key either via an “Authorization: Bearer $key” header, or with the access_token parameter. Details about each of the endpoints can be found in the CDI pull requests on Github (linked for each one).
Finally, there’s a bug in the API enumeration that incorrectly and unconditionally lists the characters inventory/equipment endpoints as disabled. We’ll look to fix that at some point in the future so it shows the status of those endpoints properly.
Questions/comments? Happy developing
This stuff sounds really important…. but I don’t get it? What does all of this stuff mean?
These API endpoints will allow a user to generate an API key which will give an application access to various pieces of information about an account.
Some new possibilities for websites/apps include:
- View inventory away from home.
- Cross-list bank contents against one of the various market trackers to see current wealth, as well as find stuff like price spikes in some old dusty skin on your storage ranger.
- Get currently equipped gear/traits(eventually) loaded directly into a build calculator.
MithranArkanere.8957:
This is one of the greatest steps towards having sites that can show account profiles.
Eearslya.6309:
So, I just made a simple page that fetches all the items in my bank and displays them on the page for me. It works fine, except for one problem.
For whatever reason, the last 14 bank slots are returned as null. They’re not empty, they’re full of Bloodstone Dust, Empyreal Fragments, and Dragonite Ore. I have 9 bank tabs, and they all work fine except for the last tab in those final 14 slots.
EDIT: After a little more thought, I realize that 270 (9*30) minus 14 is 256. So apparently anything over 256 slots isn’t shown?
Vavume.8065:
I find this all so ghetto, just make an official arenanet armory like wow has…
Lawton Campbell.8517:
For whatever reason, the last 14 bank slots are returned as null. They’re not empty, they’re full of Bloodstone Dust, Empyreal Fragments, and Dragonite Ore.
That’s super weird. Can you PM the API key you’re using? I can take at it tomorrow.
fishball.7204:
Can confirm that this does not currently allow more than 256 slots in the bank, at least for me.
The last part of the thingy returns
{"id":46733,"count":250},{"id":46752,"count":2},{"id":46733,"count":250},null,null,null,null,null,null,null,null,null,
null,null,null,null,null]
which is the Augur Stone (2) + Dragonite Ore (250).
I would also like the add that for example, my Mini Queen Jennahs of which I have multiple, the API returns that I only have 1.
Grax.9204:
Thanks for those amazing APIs!
I am currently having issues with invalid(?) inventory item IDs.
As an example, from the character API I get the ID 8702 for what are supposed to be my harpy feathers. The item API then tells me that there is no such ID.
I’ve uploaded a page to http://gw2maps.ch/char/. All the broken image icons show items with invalid IDs (the ID is visible in the html elements title). For me that’s quite a bunch. I can pass on my access token if that helps.
Here’s a list of IDs I get which seem to be invalid:
8702, 8764, 8680, 8678, 8714, 8464, 8677, 8729, 8733, 8696, 6467, 8704, 4646, 4579, 37274, 8781, 8792, 8698, 4651, 42041, 8789, 39141, 39151, 4652, 4582, 4585, 4653, 4655
Dawntree.7246:
Awesome, I can instacheck my progression to legendaries! Thank you.
Just 1 question, is wallet data included? I can’t find it…
If that’s not the case, any chance to have those as well soon?
Eearslya.6309:
Thanks for those amazing APIs!
I am currently having issues with invalid(?) inventory item IDs.
As an example, from the character API I get the ID 8702 for what are supposed to be my harpy feathers. The item API then tells me that there is no such ID.I’ve uploaded a page to http://gw2maps.ch/char/. All the broken image icons show items with invalid IDs (the ID is visible in the html elements title). For me that’s quite a bunch. I can pass on my access token if that helps.
Here’s a list of IDs I get which seem to be invalid:
8702, 8764, 8680, 8678, 8714, 8464, 8677, 8729, 8733, 8696, 6467, 8704, 4646, 4579, 37274, 8781, 8792, 8698, 4651, 42041, 8789, 39141, 39151, 4652, 4582, 4585, 4653, 4655
This has been a long-standing issue. (See: https://forum-en.guildwars2.com/forum/community/api/Item-IDs-Omitted-from-API/first )
The problem with the items endpoint is every item currently has to be manually whitelisted in order to show up in the API. (So they don’t accidentally release some in-progress HoT item or such.)
Tacco Raw.3168:
What does {"text":"ErrUnknown"} mean? Keep seeing this for /v2/materials and /v2/account/materials but not /v2/account/bank.
Chiuna.2538:
Is it possible to see how equipped items are dyed from the /eqiupment API? If not, can that be added?
Aralicia.6157:
Is it possible to see how equipped items are dyed from the /eqiupment API? If not, can that be added?
Not possible for now. But I personally like the idea, especially since dye/color data is already present thanks to the /colors endpoint.
That said, seems there’s a WIP about extending guild infos. Dyes may or may not appear afterward.
quenoz.3859:
this is super useful!
GW2 armory, here we go!
I think the last bit we’re missing for the MVP is traits/skills
does that mean that these will be added soon…? : >
Natir.7364:
I have a question with these changes. Would it allow someone to make an armory similar to World of Warcraft with being able to see what equipment they have on and maybe what abilities/traits they picked?
Obviously I didn’t see abilities/traits but I think that would be an amazing feature to see who is running what build and what equipment and runes/sigils they are using. Outside of what our entire outfit wants (because we want this with a passion), I think it would be nice to see what top players in each area are using. Like WvW, SPvP, PvE, et.
Ayusaki.6739:
this is super useful!
GW2 armory, here we go!
I think the last bit we’re missing for the MVP is traits/skills
does that mean that these will be added soon…? : >
https://github.com/arenanet/api-cdi/pull/42
https://github.com/arenanet/api-cdi/pull/5
Its on the todo list
quenoz.3859:
https://github.com/arenanet/api-cdi/pull/42
https://github.com/arenanet/api-cdi/pull/5Its on the todo list
ah, thanks! not checking github enough
Natir.7364:
Are there any plans to have these things be automated where its just mined from the player’s data automatically and they don’t have to get an API key?
Kind of further explanation from my post above but one of the things we do for our WvW is we run the same builds and gear setup for each class to make sure we maximize what we are doing. Sometimes when people keep dying, we figure out they are not running the same gear/build setup but we don’t know and thus cannot help them and show them what they may be doing wrong. It would be so much easier to just look at who is in our guild or just look up their info via their ID and check out their info to see what they are running.
Nabrok.9023:
Are there any plans to have these things be automated where its just mined from the player’s data automatically and they don’t have to get an API key?
Kind of further explanation from my post above but one of the things we do for our WvW is we run the same builds and gear setup for each class to make sure we maximize what we are doing. Sometimes when people keep dying, we figure out they are not running the same gear/build setup but we don’t know and thus cannot help them and show them what they may be doing wrong. It would be so much easier to just look at who is in our guild or just look up their info via their ID and check out their info to see what they are running.
You can do this as of yesterday, but each of your guild members needs to “opt-in” by providing an API key.
Lawton Campbell.8517:
Can confirm that this does not currently allow more than 256 slots in the bank, at least for me.
The bug that caused this is annoyingly in a fairly low-level component, so deploying the proper fix is going to take awhile. I’ve got a potential bandaid fix that I could conceivably deploy today, but it’s got some edge-cases (where the player’s bank is mostly empty) that still return broken data.
I’ll probably push it out, because I doubt that the edge cases are that common.
I am currently having issues with invalid(?) inventory item IDs.
There’s a bunch of ways to acquire items that don’t cause them to be whitelisted properly (e.g., buying them from a vendor). I’m working on fixing these bits up now, but I don’t have an ETA for when they go live 
Just 1 question, is wallet data included? I can’t find it…
If that’s not the case, any chance to have those as well soon?
Wallet data is not yet included.
Is it possible to see how equipped items are dyed from the /eqiupment API? If not, can that be added?
It’s not currently possible, but a good idea for an improvement.
Are there any plans to have these things be automated where its just mined from the player’s data automatically and they don’t have to get an API key?
Nope. If you want their data, you’re going to need their permission (in the form of their API key). Once we have the bits to pull full builds (e.g., traits/skillbar) I imagine someone will make a site which lets you easily share what builds you’re running, so they can just copy-paste a URL into TS/Mumble.
Lawton Campbell.8517:
Can confirm that this does not currently allow more than 256 slots in the bank, at least for me.
The bug that caused this is annoyingly in a fairly low-level component, so deploying the proper fix is going to take awhile. I’ve got a potential bandaid fix that I could conceivably deploy today, but it’s got some edge-cases (where the player’s bank is mostly empty) that still return broken data.
I’ll probably push it out, because I doubt that the edge cases are that common.
Just deployed the bandaid fix for this. The API will still return invalid data if:
- The user has no items in the first 255 slots OR
- If the slot index of the last item in the first 255 slots is less than the slot index of the first item after 255 — e.g., if you’ve got only got items in slots 4 and 235.
I expect most players will have quite a bit of stuff in their bank, so the above cases are fairly unlikely, I think.
The full fix should be released whenever the next patch lands.
Vegeta.2563:
Is it possible to see what traits or utility skills are being used on each character using API Keys ?
Ayusaki.6739:
Is it possible to see what traits or utility skills are being used on each character using API Keys ?
Scroll up 7 posts…
https://forum-en.guildwars2.com/forum/community/api/Launching-inventory-endpoints/first#post5215567
queicherius.2563:
Hey there,
after playing around with the new APIs I came up with a Armory-Style to display your characters (WIP)
fishball.7204:
Is the materials end point down right now? can’t seem to access it at all getting error.
{"text":"ErrUnknown"}Eearslya.6309:
Is the materials end point down right now? can’t seem to access it at all getting error.
{"text":"ErrUnknown"}
Seems to be working fine for me, both /v2/materials and /v2/account/materials. Where and how are you trying to load it?
fishball.7204:
Just using this:
https://keeky.github.io/Guild-Wars-2-API-Explorer/#v2/account/materials
T=
Edit: ok it works on my end, idk why it doesn’t work for him and it doesn’t work in my web browser (the other stuff usually displays as a blob of data but I still see it in the browser this just says error)
LAzraeL.2346:
Are the skins in characters equipments just simple items id?
Seems like I’m getting the wrong skin for some armors and backpacks..
In your example, the backpack skin is showing “Dolyak Greaves”, gloves skin is “Nika’s Pauldrons”,etc.
Edit: ah.. nvm. Didn’t realize there’s another API for skins.
MentalFS.2589:
Is there a way to find out if an item is soulbound? I can see “SoulBindOnUse” when I query the items endpoint, but not if the item was already used or not. I’m also not sure if there’s something like “AccountBindOnUse”, but the same would apply there.
Tacco Raw.3168:
Is the materials end point down right now? can’t seem to access it at all getting error.
{"text":"ErrUnknown"}Seems to be working fine for me, both /v2/materials and /v2/account/materials. Where and how are you trying to load it?
It shows when using Chrome or IE, but request sent by python code works fine.
Vegeta.2563:
I did find out that most consumables like flamethrowers, or ogre pet whistles, fire elemental powders.. things like these show up as question marks. So they don’t have an icon yet.
fro.8967:
Yes there appear to be several items that do not return from the item API when queried by ID. Some skins too probably. I noticed this a lot when making the updates to GW2 Account Viewer http://mygw2.wvwintel.com/
Lawton Campbell.8517:
Is there a way to find out if an item is soulbound?
Not yet.
I did find out that most consumables like flamethrowers, or ogre pet whistles, fire elemental powders.. things like these show up as question marks. So they don’t have an icon yet.
It’s because not all items show up on the API — they only appear once some conditions are met (e.g., someone loots it from a drop). Unfortunately, the conditions aren’t all inclusive and don’t pick up karma vendor purchases (among other things). Working on fixing that at some point in the future.
MentalFS.2589:
I’ve noticed that I get wrong counts with some items. At least minis seem to always get count 1, regardless of how many I have stacked.
Lawton Campbell.8517:
I’ve noticed that I get wrong counts with some items. At least minis seem to always get count 1, regardless of how many I have stacked.
I actually haven’t had a chance to look into that one yet (won’t be able to deploy the fix for awhile); my current hypothesis is that the stacked quantity for certain items is encoded … differently.
I’m interested to know if you’ve got any non-mini items doing this. My hunch is that it was just some debris from the patch which moved minis from collections into the wardrobe.
Loex.5104:
Activated a handful of new endpoints — mostly authenticated and require the “inventories” permission — that provide access to an account’s various inventories:
- /v2/materials - unauthenticated endpoint which provides localized names and contents for each of the material storage tabs. (CDI)
- /v2/account/bank - the contents of the account’s bank. (CDI)
- /v2/account/materials - the contents of the account’s material storage. (CDI)
- /v2/characters - will now contain equipment and inventory fields when the token has the “inventories” scope. (CDI)
- /v2/characters/:id/inventory - just the inventory data. (CDI)
- /v2/characters/:id/equipment - just the equipment. (CDI)
)
pretty neat ;D
now we just need some endpoints for the current Gold and the current Gems on an Account plz
also an Flag on the character/inventory+bank that shows if the item is actually soul / account bound or not would be awesome
Devata.6589:
I am just getting into the API (V1 didn’t really have the guild-related options I needed / wanted) so maybe a stupid question, but would this then also mean we are able to get an image of the character, maybe even an 3D object?
—
In addition I was wondering if Authentication would also get an update to allow more options for guild. So we could also use this character information for guild-members. At this moment authentication is done based on your own account-details, but that would mean (correct me if I am wrong) that I would not be able to get this information from anybody else then myself. So I cannot make a guild-roster (I know we are getting a function to get the guild-roster) where (for example) we then show the characters or the guild-members and their gear.
Guild-members could have the ability to (in advanced security options) allow guilds / guild-leaders to see some information like the armor their character have on. (some information could be on by default and some could be off by default). Than have the ability to put a password on a guild and allow for authentication using that password (So you don’t authenticate as a player but as a guild). The guild could also have its own authentication roles (what information should be available).
In that way you have a secure way to show all the type of information guilds might want to show on their site. Guild-roster, including specs of the guild-members (if members do not disable that ability), message of the day, items in the guild-bank, completed guild-missions, combined gold of all members (if members would share their amount of gold with the guild). Everything is possible, but everything can also been closed off for privacy / security reasons.
One of the main features would be the guild-roster with detailed character information of all guild-members. That is why I mention it in this thread.
darthmaim.6017:
maybe a stupid question, but would this then also mean we are able to get an image of the character, maybe even an 3D object?
Rest assured, this is something I really, really want too. There’s a lot of moving parts that need to be ironed out before it’s feasible though, so we’ll probably be sticking to low-hanging fruit for awhile yet :<
—
In addition I was wondering if Authentication would also get an update to allow more options for guild. So we could also use this character information for guild-members. At this moment authentication is done based on your own account-details, but that would mean (correct me if I am wrong) that I would not be able to get this information from anybody else then myself. So I cannot make a guild-roster (I know we are getting a function to get the guild-roster) where (for example) we then show the characters or the guild-members and their gear.
With respect to privacy, the conclusion was that the best solution is to have an in-game rank permission that grants API access. Since that’s going to take some time to implement, the initial release will be restricted to allow access only to guild leaders.
Devata.6589:
maybe a stupid question, but would this then also mean we are able to get an image of the character, maybe even an 3D object?
Rest assured, this is something I really, really want too. There’s a lot of moving parts that need to be ironed out before it’s feasible though, so we’ll probably be sticking to low-hanging fruit for awhile yet :<
—
In addition I was wondering if Authentication would also get an update to allow more options for guild. So we could also use this character information for guild-members. At this moment authentication is done based on your own account-details, but that would mean (correct me if I am wrong) that I would not be able to get this information from anybody else then myself. So I cannot make a guild-roster (I know we are getting a function to get the guild-roster) where (for example) we then show the characters or the guild-members and their gear.
With respect to privacy, the conclusion was that the best solution is to have an in-game rank permission that grants API access. Since that’s going to take some time to implement, the initial release will be restricted to allow access only to guild leaders.
I missed that first reply. Thanks!
The second one I did read (it was an answer to another question of me) but does not fully answer the question.
What does this ‘in-game rank permission that grants API access’ mean?, as I see it, it would only allow a guild to toggle on or off the ability for anybody to get access to guild-information (maybe detailing what information). Something you might not want. As guild I might not want everybody being able to get the guild-roster or MotD, but I might want to have the ability myself to put it on the guild-site. In addition it would not allow to get detailed character information from characters as that still requires authentication with the account from the owner of that character.
(Heck you could even allow for two rights, one for public use, and one for personal / guild-site use)
Or maybe the ‘in-game rank permission that grants API access’ is more in line with what I talk about here. But that is not completely clear to me.
darthmaim.6017:
To get character info you will probably always need the API key of the owner-account, you will only be able to get guild informations with the ingame permission.
Devata.6589:
To get character info you will probably always need the API key of the owner-account, you will only be able to get guild informations with the ingame permission.
If this is the case then see what I talked about as a suggestion, as that would allow for much more freedom / options (especially for guild-sites) while still allowing for the same (or more) security and privacy-options.
MentalFS.2589:
I’m interested to know if you’ve got any non-mini items doing this. My hunch is that it was just some debris from the patch which moved minis from collections into the wardrobe.
I couldn’t find any other items with that problem. Actually I did remove the minis from the old materials section and place them in the bank yesterday, maybe it’s one of those problems that would autofix when I take the items on a ride to another map? I’ll try that later.
What does this ‘in-game rank permission that grants API access’ mean?
I think it’s a permission in the rank system (like guild vault access) that grants the member access to guild information with the API, not the other way around and definately nothing for public access. At least that’s how I understood it.
darthmaim.6017:
What does this ‘in-game rank permission that grants API access’ mean?
I think it’s a permission in the rank system (like guild vault access) that grants the member access to guild information with the API, not the other way around and definately nothing for public access. At least that’s how I understood it.
That also what I am thinking.
Devata.6589:
Oke, so then the member with that permission uses his personal key to authenticate and then has access to all the guild-information, that makes much more sense.
It would however still be nice if guild-members could also give permissions to the guild, to get some details from their personal account.
zeeZ.5713:
But they can… by giving their guild their API keys
Devata.6589:
But they can… by giving their guild their API keys
Yeah I did think about that, but then you have to get all members to give the key and then you immediately can see all information, including what is on their bank and so on.
It would make sense that members might want to show their gear but not what is on the bank.
MentalFS.2589:
Gearchecks come to mind. It might be worth a discussion to either include the equipment regardless of the inventories permission (but some people might not want to reveal that, only their names and race/profession) or make an additional permission only for equipment (although we don’t want permission creep with seventy thousand checkboxes on the API key page).
MatHack.4316:
Considering what Lawton has said in the past, I highly doubt any guild member will be able to get more information about another guild member than is currently visible in the in-game guild panels.
I do feel something for the suggestion made above about a guild member giving the whole guild permission to see (a limited) amount of data from their account. In my opinion this should be a limited set of data, and not all data available through /account and /characters. If you want all the data from a guild member, just ask them for an api-key and save those on a guild website/database.
I do however think that it will take a while before this suggestion (if approved) will be implemented considering Lawtons reaction about the guild permissions. I also think this will probably be a new permission within the api-key account page. To limit the user’s confusion/overwhelming about permissions I do agree with ArenaNets philosophy to keep the permission count limited. Just some things to ponder over.
AysonCurrax.3254:
Would it be possible to add what crafting professions a particular character has, including the level? perhaps make it an endpoint of its own that would list all the recipes a particular character has learned?
something along the lines of adding a crafting_professions field to v2/characters, and then perhaps a sub-endpoint along the lines of
v2/characters/:id/crafting_professions/{id}
or
v2/characters/:id/crafting_professions/{profession_name}
with a list of all available recipes.
Lawton Campbell.8517:
What does this ‘in-game rank permission that grants API access’ mean?
I think it’s a permission in the rank system (like guild vault access) that grants the member access to guild information with the API, not the other way around and definately nothing for public access. At least that’s how I understood it.
That also what I am thinking.
Yeah, that’s what I meant.
But they can… by giving their guild their API keys
It would make sense that members might want to show their gear but not what is on the bank.
I’ve been thinking about this; I think I’m going to add a “builds” permissions that grants access to traits/skillbar/equipment — such that you can get the “equipment” with either the “builds” or “inventory” permissions.
It might be kind of gross like that, but having it enabled by “inventory” allows the “dude-wheres-my-mini.com” use-case for solving “which character has my ascended gs?”
I do feel something for the suggestion made above about a guild member giving the whole guild permission to see (a limited) amount of data from their account.
For the initial release of the guild endpoint, the roster will only have the account name. My idea was to leverage the API key permission bits to allow guild members to select exactly what they want to share (by requiring them to give out an API key).
It might be possible to move that in-game but that’s not my department, so it’ll take quite a bit more time and effort.
Would it be possible to add what crafting professions a particular character has, including the level?
Yes. Also which ones are currently active.
MentalFS.2589:
I just took my Mini Queen Jennas on a ride to Lion’s Arch and put them back in the bank, but it’s still showing count = 1 (I’ve waited about 15 minutes).
Devata.6589:
What does this ‘in-game rank permission that grants API access’ mean?
I think it’s a permission in the rank system (like guild vault access) that grants the member access to guild information with the API, not the other way around and definately nothing for public access. At least that’s how I understood it.
That also what I am thinking.
Yeah, that’s what I meant.
But they can… by giving their guild their API keys
It would make sense that members might want to show their gear but not what is on the bank.
I’ve been thinking about this; I think I’m going to add a “builds” permissions that grants access to traits/skillbar/equipment — such that you can get the “equipment” with either the “builds” or “inventory” permissions.
It might be kind of gross like that, but having it enabled by “inventory” allows the “dude-wheres-my-mini.com” use-case for solving “which character has my ascended gs?”
I do feel something for the suggestion made above about a guild member giving the whole guild permission to see (a limited) amount of data from their account.
For the initial release of the guild endpoint, the roster will only have the account name. My idea was to leverage the API key permission bits to allow guild members to select exactly what they want to share (by requiring them to give out an API key).
It might be possible to move that in-game but that’s not my department, so it’ll take quite a bit more time and effort.
Would it be possible to add what crafting professions a particular character has, including the level?
Yes. Also which ones are currently active.
Thanks for considering it.
It would be a huge improvement from a guild-perspective as it would allow them to make detailed guild-rosters of all members (and possible old members) showing how they are geared, maybe in the future even the achievements.
If we would be able to get the character coordinates you could even make a real-time map showing where all members are.
Well it would give a lot of options while still allowing the guild-members their privacy they deserve / want.
At the current approach it would be everything or nothing. I understand that at the current stage requesting API-keys is the most logical option, but if that could eventually move to a member giving the guild permissions you could really have an automated system without having to ask new members for an API-key.
Again thanks for considering it and keep up the good work.
isingrel.2350:
Would it be possible to get the current number of charges on a consumable item; salvage kits, gathering tools?
Eearslya.6309:
I’ve been thinking about this; I think I’m going to add a “builds” permissions that grants access to traits/skillbar/equipment — such that you can get the “equipment” with either the “builds” or “inventory” permissions.
It might be kind of gross like that, but having it enabled by “inventory” allows the “dude-wheres-my-mini.com” use-case for solving “which character has my ascended gs?”
If you wanted to make an endpoint just for builds, perhaps all that is necessary to give is the stats/runes/sigils of the armor and weapons, rather than the actual items and skins equipped?
darthmaim.6017:
Would it be possible to get the current number of charges on a consumable item; salvage kits, gathering tools?
Gathering tool uses aren’t currently pulled out of the character data, but it’s something I can look into adding.
(source)
—
I’ve been thinking about this; I think I’m going to add a “builds” permissions that grants access to traits/skillbar/equipment — such that you can get the “equipment” with either the “builds” or “inventory” permissions.
It might be kind of gross like that, but having it enabled by “inventory” allows the “dude-wheres-my-mini.com” use-case for solving “which character has my ascended gs?”
If you wanted to make an endpoint just for builds, perhaps all that is necessary to give is the stats/runes/sigils of the armor and weapons, rather than the actual items and skins equipped?
Lawton was talking about a new permission, not an endpoint. Both the inventory and build permissions give access to the endpoint /v2/characters/:id/equipment.