arenanet / api-cdi

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

Add PvP Reward Track Info and metadata #279

Open milneti opened 8 years ago

milneti commented 8 years ago

It could be a nice addition to be able to track in-game pvp reward track progress / completion history. Not how the data is being stored backend though :) ... potential setup could be:

/v2/account/pvp/rewards/ contains array of reward track objects and the accounts status (protected by pvp / progression permissions?).

{
    id : 3920,
    active : true/false
    progress : 15, // in terms of rewards (like 15 / 40 unlocked)
    completed : 3, //number of completions (includes repeated completions)
    unlocked : true //only if perm unlocked. otherwise check avaiable in /v2/pvp/rewards
}

reward track ids map to: /v2/pvp/rewards?ids=id,all Each reward track object can contain:

{
    id : 3920,
    name: "Jungle Bear Rank Reward Track",
    prerequisite : 3919,
    num_tiers : 8,
    rewards_per_tier : 5,
    available : true, //for the timed availability ones (like dungeon tracks that are not perm unlocked)
    tags ["repeatable"],
    tiers : [
        {
            tier_num : 1 
             rewards : [
                 {
                     id : 1111,
                     exp_required : 500
                 },
                 ...
            ]
        },
       ...
    ]
}

Names of things are a toss-up. I am bad at naming. Wanted to throw the idea out though. Any opinions / suggestions feel free to comment.

lye commented 8 years ago

Seems reasonable to me. Haven't looked at the reward tracks stuff yet, but the prerequisite would probably be an array.