These forums have been archived and are now read-only.

The new forums are live and can be found at https://forums.eveonline.com/

EVE Technology Lab

 
  • Topic is locked indefinitely.
 

EVE Swagger Interface - Changelog

First post
Author
Previous Topic Next Topic
CCP SnowedIn
C C P
C C P Alliance
#1 - 2016-11-08 23:01:32 UTC  |  Edited by: CCP Bartender
Edit: We have moved where we are updating this information, please see "schedule of breaking changes" in this blog for details: https://developers.eveonline.com/blog/article/breaking-changes-and-you

Hello,

This is where breaking changes to the ESI API will be announced.

A reminder to use the versioned path to the endpoints important to you if you do not want to face unexpected changes (that is, without checking this changelog). You should also make special note of any Warning headers returned; they are early indicators that updates are available or the route you are using may be going away soon.

To test the most recent specs, which are subject to change without notice, feel free to check out http://esi.tech.ccp.is/dev/.

Breaking changes to https://esi.tech.ccp.is/latest/ will be announced in this forum post.

If you don't want to use the numerically versioned route for each endpoint, and in the case of a change, previously available routes from /latest/ will be under /legacy/. If a route is being deleted, an alternative will be provided in the Warning header as well as being announced in this changelog.

More details on ESI are available in the developers blog announcing it.

CCP SnowedIn // Distributed Systems Engineer // Team Tech Co // @CCP_SnowedIn
CCP SnowedIn
C C P
C C P Alliance
#2 - 2016-11-30 17:09:48 UTC
Hello,

We are planning a couple very minor breaking changes today.

First, we are changing the output parameter ancestry_id on GET /characters/{character_id}/ to being optional. Some characters (DUST) would error on that attribute, so effectively there is no change externally. All characters that used to return an ancestry_id will continue to do so, any characters that resulted in an error reply will now be returned without an ancestry_id.

Secondly, we are removing "Dummy" tagged routes from visibility because they were causing confusion/unneeded noise. In the same vein, we are also removing the "Live" tags. After this change, routes should only be tagged with a single tag.

That's all for today, for more details/status updates feel free to join us in #ESI on tweetfleet slack.

CCP SnowedIn // Distributed Systems Engineer // Team Tech Co // @CCP_SnowedIn
CCP SnowedIn
C C P
C C P Alliance
#3 - 2016-12-07 19:01:10 UTC
Hello,

Another couple minor breaking changes planned for today.

The "executor_corp" attribute in the return of GET /alliances/{alliance_id}/ will be changed from required to optional. This attribute is not available for closed alliances. Currently if you request a closed alliance this route would result in an error.

This does not affect the return of active alliances.

On the same endpoint, in relation to https://github.com/ccpgames/esi-issues/issues/64 , we are also renaming the "executor_corp" attribute to "executor_corporation_id" on the /dev/ version only. This will be moved up to /latest/ in the next week, and you can expect more changes like this in the next while as we bring more endpoints into consistency.

Another minor change scheduled for today is to remove "wormhole" from the "categories" enum on:

  • get /characters/{character_id}/search/
  • get /search/

You can search wormholes with the "solarsystem" category. Wormholes were never actually available with the "wormhole" tag anyway, so no functional change there.

That's all for now!

CCP SnowedIn // Distributed Systems Engineer // Team Tech Co // @CCP_SnowedIn
CCP SnowedIn
C C P
C C P Alliance
#4 - 2017-01-17 21:11:47 UTC
Greetings capsuleers,

A breaking change is planned for today, but it's to resolve an issue currently impacting production, hence the short notice.

For full details, please see this github issue: https://github.com/ccpgames/esi-issues/issues/209

All translated routes will be changing from using the standard "Accept-Language" header to using a "language" query string parameter.

The routes affected by this are:

GET /fleets/{fleet_id}/members/
GET /fleets/{fleet_id}/wings/
GET /insurance/prices/


As we are also planning on adding more endpoints that support translation, it's important to resolve this now.

Again, apologies for the short notice.

CCP SnowedIn // Distributed Systems Engineer // Team Tech Co // @CCP_SnowedIn
CCP SnowedIn
C C P
C C P Alliance
#5 - 2017-01-18 17:03:47 UTC
Due to an issue with a db proc, the /wars/ endpoint has been temporarily disabled.

Expected to return next Tuesday.

CCP SnowedIn // Distributed Systems Engineer // Team Tech Co // @CCP_SnowedIn
CCP Bartender
C C P
C C P Alliance
#6 - 2017-01-31 15:59:25 UTC
Hi all,

Apologies, we should have telegraphed this ahead of time, but better late than never. /v1 of /universe/names has been moved to /legacy, and /v2 is now /latest.

This is a breaking change, as the format of the JSON submitted to this endpoint has changed. You can continue using /v1 for the moment, but you should upgrade to /v2 when you have time, as if we make a /v3 and promote it to latest, /v1 will cease to exist.

Thanks!
CCP Bartender
C C P
C C P Alliance
#7 - 2017-02-01 14:31:50 UTC
We have moved where we are updating this information, please see "schedule of breaking changes" in this blog for details: https://developers.eveonline.com/blog/article/breaking-changes-and-you