arenanet / api-cdi

Collaborative Development Initiative for Public APIs
253 stars 41 forks source link

Expose bought living story, fractal and account upgrades #382

Open Archomeda opened 7 years ago

Archomeda commented 7 years ago

Update: A year later with more maps being added with account-wide unlocks, I think it's safe to say that a separate endpoint like /v2/account/unlocks and possibly /v2/unlocks (or maybe upgrades) is a good idea.

We currently have (non-exhaustive list):

Unlock / Upgrade Location
Gold Find (%) Account-wide bonus
Karma Gain (%) Account-wide bonus
XP Gain (%) Account-wide bonus
Magic Find (%) Account-wide bonus
Fractal Empowerment (4 tiers) Fractals upgrade
Karmic Retribution (4 tiers) Fractals upgrade
Agony Impedance (4 tiers) Fractals upgrade
Mist Attunement (4 tiers + 1 title/tier) Fractals upgrade
Bloodstone Empowerment (3 tiers) Bloodstone Fen map upgrade
Focused Magic Bloodstone Fen gliding skill 1 unlock
Unstable Magic Volley Bloodstone Fen gliding skill 2 unlock
Pacified Magical Storm Bloodstone Fen gliding skill 3 unlock
Dogfight or Flight Bloodstone Fen gliding skill 4 unlock
Ride the Ley Line Bloodstone Fen gliding skill 5 unlock
Karmic Retribution (3 tiers) Ember Bay map upgrade
Karmic Retribution (3 tiers) Bitterfrost Frontier map upgrade
Sprint Bitterfrost Frontier torch skill 1 unlock
Koda's Reach Bitterfrost Frontier torch skill 2 unlock
Enflame Bitterfrost Frontier torch skill 3 unlock
Koda's Breath Bitterfrost Frontier torch skill 4 unlock
Koda's Rebirth Bitterfrost Frontier torch skill 5 unlock
Draconis Mons Empowerment (3 tiers) Draconis Mons map upgrade
Karmic Retribution (3 tiers) Siren's Landing map upgrade
Istani Empowerment (3 tiers) Domain of Istan map upgrade
Karmic Retribution (3 tiers) Domain of Istan map upgrade
Extraction Beam Domain of Istan Brandstone Multitool skill 3 unlock
Reconfigure Multiool Domain of Istan Brandstone Multitool skill 4 unlock
Impact Site Marker Domain of Istan Brandstone Multitool skill 5 unlock
Sandswept Empowerment (3 tiers) Sandswept Isles map upgrade
Karmic Retribution (3 tiers) Sandswept Isles map upgrade
Domain of Kourna Empowerment (3 tiers) Domain of Kourna map upgrade
Karmic Retribution (3 tiers) Domain of Kourna map upgrade

Original: There are map upgrades like Bloodstone Empowerment and Karmic Retribution that, once bought, are unlocked for every character. I'm not aware of any other upgrades that work like this.

Not sure where this might fit in. Maybe it's small enough for /v2/account, or maybe it will be used more often in future upgrades (or when there's already more account wide unlocks like this, maybe combine it with the home instance nodes?) and warrants its own endpoint like /v2/account/unlocks.

Refs #228

regendo commented 7 years ago

The Bloodstone Fen gliding skills also work like this.

Archomeda commented 7 years ago

Nowadays it also applies to the Karmic Retribution in Bitterfrost Frontier. But those are separate from the one in Ember Bay of course. We now also have the torch skills in Bitterfrost Frontier.

Now that I think about it, I think this can include almost every unlock or upgrade you can only buy once at a vendor. Might be easier to check it this way as well. Although I think a whitelist might be needed for this.

lye commented 7 years ago

Although I think a whitelist might be needed for this.

They'd have to be hardcoded, since the upgrades are all generic one-offs that set a flag that a script somewhere checks. That's not that big of a deal, but the way the system is implemented effectively prevents me from taking a more generic approach :<

Archomeda commented 6 years ago

After a year of content, I've updated the first post with lots of new available account upgrades.