Some endpoints i'd like.

Some endpoints i'd like.

in API Development

Posted by: Tshakaar.6429

Tshakaar.6429

/characters/:id/dungeons
To know which story paths each character did without visiting each dungeon.

{
 "dungeons":{
  "story":[
   "caudecus_manor",
   "honor_of_the_waves",
   "ruined_city_of_arah"
  ],
  "exploration":[
   {
    "id": "twilight_arbor",
    "paths": [
      {
        "id": "leurent"
      }
    ]
   },
    {
    "id": "crucible_of_eternity",
    "paths": [
      {
        "id": "teleporter"
      },
      {
        "id": "front_door"
      }
    ]
   }
  ]
 }
}

/characters/:id/exploration
To know what each character still need to explore.

{
 "lions_arch":{
  "total": 22,
  "vista": 2,
  "poi": 3,
  "waypoint": 1
 }
 "dry_top":{
  "total": 75,
  "vista": 4,
  "poi": 6,
  "waypoint": 3
 }
}

/exploration
To gather number of vistas, poi, wp etc in each zone.

/character/:id/story
To know which steps of personal story, living world seasons, HoT, etc. each character has done and the one at which he is currently.

(edited by Tshakaar.6429)

Some endpoints i'd like.

in API Development

Posted by: roj.1085

roj.1085

Ha, I just asked about the same thing on your last point, story.*

I hadn’t thought about exploration in such fine detail; you can track which maps are complete and which aren’t by achievements, but you’re probably doing that now and annoyed at it.

Likewise, you can cobble together that first list from achievements; I’m actually currently doing this, you can look at the achievement for twilight arbor (twilight’s idol) and the part of it with ‘story’ in the name is the story. Just displaying the ‘Dungeons’ achievement category gets you halfway there, admittedly with cruft since dungeon frequenter and dungeon master are in that category.

*The search box on this forum doesn’t work for me… is it that I’m using Chrome?

Some endpoints i'd like.

in API Development

Posted by: Lawton Campbell

Lawton Campbell

Web Programmer

Next

Likewise, you can cobble together that first list from achievements; I’m actually currently doing this, you can look at the achievement for twilight arbor (twilight’s idol) and the part of it with ‘story’ in the name is the story

Annoyingly enough, the story mode completions are tracked on a per-character basis, not per-account. There’s no current way to get those per-character unlocks out of the API

Other notes:

The exploration/story stuff is, uhh, surprisingly complex and very difficult to expose in a structured manner.

(edited by Lawton Campbell.8517)

Some endpoints i'd like.

in API Development

Posted by: Khisanth.2948

Khisanth.2948

For the story mode unlock … maybe there is a slightly roundabout way that could be easier? What if you check the list of available/unlocked WvW/PvP reward tracks? Those are account bound.

Some endpoints i'd like.

in API Development

Posted by: Lawton Campbell

Previous

Lawton Campbell

Web Programmer

Next

So funny thing, I looked at the actual bits and bobbles after posting that. Not only was I totally mistaken about the story data being hard to expose, at some point I’d already written the backend implementation to dump out the journal stuff?

It needs to be massaged into a usable API, but I can probably have a PR for the details on github next week.

Some endpoints i'd like.

in API Development

Posted by: Tshakaar.6429

Tshakaar.6429

roj, all you propose to do by achievements will give me a per-account stats. I want a per-character.

Lawton, oh, i quickly took a look on the forum, and totally forgot to check Github for what i asked, sorry.
But all i can say to “I can probably have a PR for the details on github next week.” is “/me purrs”

Some endpoints i'd like.

in API Development

Posted by: Lawton Campbell

Previous

Lawton Campbell

Web Programmer

Made a pull request containing a first-pass attempt at exposing the localized story data. The personal story is a bit wonky in that it’s branching — which is kind of weird to expose due to the implementation. There’s a handful of additional endpoints that will need to be made in /v2/characters (and maybe /v2/account?) to expose which story paths have been chosen, as well as which stories/chapters have been unlocked. And which have been completed, naturally.

Comments/suggestions are always welcome; especially RE: expressing chapter branches.

Some endpoints i'd like.

in API Development

Posted by: roj.1085

roj.1085

It’s always the the same amount though, right? Each story, no matter your choices? I might not be reading the chart right, but if so, a character’s personal story can just be an array of ids, no?

Then the /story and /story/seasons can fill in the details…

Although it looks like your choices are chapters, so maybe there also needs to be a /story/chapters endpoint… in which case the character’s array is a list of chapter ids. and story chapters provides a list of those.

Then using character info, you can piece together a full list of titles or a progress bar or whatever.