New endpoints: minis and account/minis
Lawton Campbell.8517:
Just turned on two new endpoints today: /v2/minis and /v2/account/minis.
These are fairly straightforward endpoints. They provide access to mini-specific metadata (there isn’t much) and account mini unlocks. /v2/minis is bulk-expanded and works in the same manner as all the other bulk-expanded endpoints:
- /v2/minis — provides a list of ids.
- /v2/minis?page=0&page_size=50 — gives you a paginated view (check the X-Page-Total header for the number of pages).
- /v2/minis?ids=1,2,3 — lets you grab individual minis (up to 200)
- and /v2/minis?ids=all — lets you grab all of ’em.
/v2/account/minis is an authenticated endpoint and requires an API key with both the “account” and “unlocks” permissions. You can pass the API key either via the “?access_token=X” query parameter or via an “Authorization: Bearer X” header (though note we don’t support non-simple CORS requests, so for client-side web applications you’ll need to use the former).
/v2/account/minis returns ids that can be resolved against /v2/minis.
Here’s the Github pull request which includes the output format details.
RedGlow.2715:
This is beautiful! Thanks :-)
Elfo Bianco.3786:
Thank you for these useful endpoints, but I have already a question.
Why there isn’t a property like “mini_set” or “mini_group” that let us know in which set/group a given mini belongs to, expecially for the 3 known mini sets, but also for the halloween minis, the wintersday minis, etc…?
queicherius.2563:
Bugreport time!
- Mini with id “208” has a broken name (“((46388))”)
- Item ids set that are missing in the item endpoints 49285, 67845, 70112, 74532, 71258, 70703, 74762, 70234, 71848, 74055, 73476, 76663, 74444, 70684, 70191, 70888, 73378, 73749, 71835, 76594, 76745, 74595
Kuzzi.2198:
The best. Thank you so much for the continued support.
Lawton Campbell.8517:
- Mini with id “208” has a broken name (“((46388))”)
The item to unlock that mini is … gift of sprockets?
- Item ids set that are missing in the item endpoints 49285, 67845, 70112, 74532, 71258, 70703, 74762, 70234, 71848, 74055, 73476, 76663, 74444, 70684, 70191, 70888, 73378, 73749, 71835, 76594, 76745, 74595
Gonna go through these probably early next week and figure out which of those are just broken and remove the ones that are from the list.
Thanks for the report <3
Thank you for these useful endpoints, but I have already a question.
Why there isn’t a property like “mini_set” or “mini_group” that let us know in which set/group a given mini belongs to, expecially for the 3 known mini sets, but also for the halloween minis, the wintersday minis, etc…?
Ah, I didn’t even think about that. I’ll see if I can dig up where that data is stored and expose it.
Nabrok.9023:
- Mini with id “208” has a broken name (“((46388))”)
The item to unlock that mini is … gift of sprockets?
- Item ids set that are missing in the item endpoints 49285, 67845, 70112, 74532, 71258, 70703, 74762, 70234, 71848, 74055, 73476, 76663, 74444, 70684, 70191, 70888, 73378, 73749, 71835, 76594, 76745, 74595
Gonna go through these probably early next week and figure out which of those are just broken and remove the ones that are from the list.
Thanks for the report <3
Thank you for these useful endpoints, but I have already a question.
Why there isn’t a property like “mini_set” or “mini_group” that let us know in which set/group a given mini belongs to, expecially for the 3 known mini sets, but also for the halloween minis, the wintersday minis, etc…?Ah, I didn’t even think about that. I’ll see if I can dig up where that data is stored and expose it.
Note that there’s also collections for those, so if a collections endpoint was just about ready to go …
Elfo Bianco.3786:
Note that there’s also collections for those, so if a collections endpoint was just about ready to go …
I don’t know if ArenaNet considers the minipets as the official wiki page do expecially for the “group”, “set”, “family”, call it as you want. Anyway most of them are not part of a collection; I think you are talking about the achievement collections.
Nabrok.9023:
Note that there’s also collections for those, so if a collections endpoint was just about ready to go …
I don’t know if ArenaNet considers the minipets as the official wiki page do expecially for the “group”, “set”, “family”, call it as you want. Anyway most of them are not part of a collection; I think you are talking about the achievement collections.
There are no other kinds of collections (what was previously called collectibles are now called materials).
The only thing that really matters is which collection the mini falls into, and if it doesn’t fall into one an app could just call it “other”.
cisco.9510:
Found another bug: The minis, that have the unlock string property, are not translated into the languages you are requesting. For names its working.
Test it:
https://api.guildwars2.com/v2/minis/382?lang=en <-normal
https://api.guildwars2.com/v2/minis/382?lang=de <-unlocks still english
https://api.guildwars2.com/v2/minis/382?lang=fr <-unlocks still english
https://api.guildwars2.com/v2/minis/382?lang=es <-unlocks still english
Lawton Campbell.8517:
Found another bug: The minis, that have the unlock string property, are not translated into the languages you are requesting. For names its working.
Whoops. That’ll be fixed the next time I do a deploy (probably mid-late next week).