eve-val/evelink

Summarize and research API changes for which EVELink needs updates

ayust opened this issue · 18 comments

A number of various changes to the EVE API are scheduled to be released with the Crius patch (plus, there are some that came out already, like those mentioned in #159, which we still haven't added support for). Unfortunately, EVE API documentation sucks, and EVE API change documentation sucks even more.

In order to actually comprehensively update EVELink to support the changes up to Crius we need to know what all of the changes are so that we can track update progress. This issue is for that purpose.


Dev blogs and forum posts

2014-03-07 API Changes on SiSi
2014-06-04 POCOs and Wars coming to an API near you!
2014-06-18 Upcoming API Changes for Industry

(If you know of any other relevant posts, please add them to the comment thread.)

The new data returned by char/IndustryJobs and char/IndustryJobsHistory looks like this:
https://gist.github.com/ayust/e257b2d3f38e4ced0ac1

  • IndustryJobs output has changed, both in terms of format, and now that it only returns current jobs.
  • IndustryJobsHistory has been added; it uses the same format as the new IndustryJobs but contains both current and historical jobs, it is however limited to a certain number (1000 as of this writing).

Other endpoints that have been added:

  • corp/CustomsOffices requires a director+ corp key (with assets mask) and lists POCOs
  • corp/Facilities requires factorymanager corp key, lists production facilities (both POS and station)

IndustryJobs and IndustryJobsHistory have been updated in the master...crius branch.

Your point about documentation and change documentation sucking is very
valid. We are trying to get better at both.

The Crius patch notes contain changes for the API:
http://community.eveonline.com/news/patch-notes/patch-notes-for-crius

It's not great but we are trying to get better. :)

Regner Blok-Andersen
http://highguard.net/

On Tue, Jul 8, 2014 at 5:25 AM, Amber Yust notifications@github.com wrote:

A number of various changes to the EVE API are scheduled to be released
with the Crius patch (plus, there are some that came out already, like
those mentioned in #159 #159,
which we still haven't added support for). Unfortunately, EVE API
documentation sucks, and EVE API change documentation sucks even more.

In order to actually comprehensively update EVELink to support the changes
up to Crius we need to know what all of the changes are so that we can

track update progress. This issue is for that purpose.

Dev blogs and forum posts

2014-03-07 API Changes on SiSi
https://forums.eveonline.com/default.aspx?g=posts&m=4318803
2014-06-04 POCOs and Wars coming to an API near you!
http://community.eveonline.com/news/dev-blogs/pocos-and-wars-coming-to-an-api-near-you/
2014-06-18 Upcoming API Changes
http://community.eveonline.com/news/dev-blogs/upcoming-api-changes-for-industry/

(If you know of any other relevant posts, please add them to the comment
thread.)


Reply to this email directly or view it on GitHub
#171.

Thanks for the additional link.

Speaking of that link, @regner - it appears there's a typo here:

dated char/IndustryJobsFixed cache timers on the corp/Medals and api/ApiCalls endpoints

I'm assuming that should be two bullet points - "Updated char/IndustryJobs" and then "Fixed cache timers on..."

Yea, I asked them to fix that but am on vacation and it's hard to get
people to listen from this far away. Sorry.
On Jul 21, 2014 9:59 PM, "Amber Yust" notifications@github.com wrote:

Speaking of that link, @regner https://github.com/Regner - it appears
there's a typo here:

dated char/IndustryJobsFixed cache timers on the corp/Medals and
api/ApiCalls endpoints

I'm assuming that should be two bullet points - "Updated
char/IndustryJobs" and then "Fixed cache timers on..."


Reply to this email directly or view it on GitHub
#171 (comment).

@regner Haha, no worries - I can sympathize. Hope your vacation is going well!

Example data for corp/Facilities is available here:
https://neweden-dev.com/Corp/Facilities

Unfortunately CustomsOffices is not yet listed there.

Also just noticed that API/CallList was added, but EVELink doesn't support it yet. At some point that should be fixed.

https://neweden-dev.com/API/CallList

CallList has been there for a long time, but I would hold off on touching
it anytime soon as I have plans to revamp it almost completely. :)

Regner Blok-Andersen
http://highguard.net/

On Mon, Jul 21, 2014 at 10:13 PM, Amber Yust notifications@github.com
wrote:

Also just noticed that API/CallList was added, but EVELink doesn't
support it yet. At some point that should be fixed.

https://neweden-dev.com/API/CallList


Reply to this email directly or view it on GitHub
#171 (comment).

Yeah, it's not really critical to most users of EVELink, given that typically they're using an API library because they don't want to care about what the actual API endpoints are. :)

Industry endpoint changes merged in at 6c7c802. Facilities and customs offices endpoints still need to be handled but they're not yet covered by EVELink so it's not as much of a rush to have it in before Crius release.

There are some new changes coming with Phoebe. While I am not done yet and still have some more to add you can see an example of the new char/CharacterSheet output here: http://pastebin.com/4P4m1TYQ

Key things to note:
homeStationID
cloneTypeID
freeSkillPoints
freeRespecs
cloneJumpDate
lastRespecDate
lastTimedRespec
And the jumpClones rowset

I will try and get a dev blog out about it in the next few weeks, but incase someone has spare time and wants to integrate those changes. :)

Great, thanks!

On Wed, Oct 8, 2014, 15:11 Regner notifications@github.com wrote:

There are some new changes coming with Phoebe. While I am not done yet and
still have some more to add you can see an example of the new
char/CharacterSheet output here: http://pastebin.com/4P4m1TYQ

Key things to note:
homeStationID
cloneTypeID
freeSkillPoints
freeRespecs
cloneJumpDate
lastRespecDate
lastTimedRespec
And the jumpClones rowset

I will try and get a dev blog out about it in the next few weeks, but
incase someone has spare time and wants to integrate those changes. :)


Reply to this email directly or view it on GitHub
#171 (comment).

👍

As of c2a7b14 both customs offices and facilities are implemented; the Phoebe changes were finished out with d663d5c. I'm going to close out this issue since all of the changes it refers to are now incorporated into EVELink; @regner if you want to file new issues for future patches I'd welcome them. :)