Third Party Developer Blog

rss Viewing all items

Jun
19

The ESI API is a shared resource, do not abuse it

Team Tech Co | 2018-06-19 16:01
Greetings developers. As you all know, the ESI API is a shared resource among all of New Eden's citizens, and we work closely with developers to foster good practices and ensure everyone has equal access to it. Team Tech Co has for some time now been monitoring the usage of the /search/ routes, and we are sad to report that several developers are placing disproportionate load on the search service in order to achieve goals that it was never intended to serve. The goal of the search endpoint is to allow developers to upstream the searching for and autocompletion of the names of various types of entities in the eve universe. This saves third party developers the trouble of implementing their own search whilst also providing a more comprehensive search experience, and makes life better for everyone. Unfortunately, some developers have for some time ... read more
Jun
19

Updated ESI Quick Reference For New Developers

Team Tech Co | 2018-06-19 15:59
ESI Quick Reference For New Developers This blog post is part of a series of blogs examining best practices for ESI development. Each blog will be published on the 8th of each month during the journey towards XML API and CREST’s termination date. The legacy APIs will be terminated on May 8th, 2018. With the recent announcement that ESI has now reached parity with XML API and CREST there will undoubtedly be newcomers to ESI (welcome!). A lot of important information about ESI is strewn about in various blogs and may be overwhelming to newcomers. This blog will act as a quick reference for the most important things every new ESI developer should know listed all in one document. What is ESI? A RESTful API for EVE built using the OpenAPI 2.0 specification. ... read more
Jun
15

Breaking Changes to /characters/names and /corporation/names

Team Tech Co | 2018-06-15 17:40
Breaking Changes to /characters/names and /corporations/names Over the past day it has come to Team Tech Co's attention that a few ESI routes are backed by poorly optimized software patterns. Some of these routes can and will be fixed with no disruption, but not all of them. Now that Team Tech Co. is aware of the problem we want to rectify it swiftly. On Monday, June 18th 2018, we will be removing four routes. Two of these follow our standard promotion mechanism, whereby their legacy versions will be removed and their latest versions will be served on both latest and legacy. However, it will be necessary to remove two routes that, up until now, have been considered fully functional (albeit with their functionality fully replaced by a different route). Of the routes you need to know about, they are: ... read more
May
7

A Eulogy for XML & CREST

Team Tech Co | 2018-05-07 14:10
18 months ago we announced both ESI and our intention to retire the XML API and CREST by May 8th, 2018. This is a reminder that this retirement date is finally upon us! Tomorrow after downtime both CREST and XML API will not be usable anymore. This means any software you are using that has not moved to ESI will stop working. If you need to find an alternative to your favorite XML or CREST-only tools you can have a look at this curated list of EVE third-party software maintained by our awesome community! The XML API was first announced in 2007 and was known as the "EVE API". The XML API was one of the first APIs to ever be released for a major popular video game and allowed the community to make ... read more
May
2

ESI ETag Best Practices

Team Tech Co | 2018-05-02 10:28
o7 Space Friends, CCP SnowedIn coming at ya with a blog detailing a recent change to ESI response headers. As some of you have already noticed (especially if you follow me on twitter, which you should), ESI now returns an ETag header in every response. This blog is to detail exactly what this means, and how you can use this in your applications to save yourself (and us) some bandwidth. What are ETags? Entity Tags are described in RFC7232. ESI strives to follow this RFC, and any violations should be raised as a bug on ESI-Issues. The tl;dr of the above RFC is there are two types of ETags, strong and weak. ESI can return either. For your application the implementation is the same, you should store and use the entire ETag header value without ... read more
Apr
27

ESI Chat Channel Deprecation

Team Tech Co | 2018-04-27 15:10
ESI Chat Channel Deprecation Ever since EVE's new chat backend was released on March 20th the ESI route /v1/characters/{character_id}/chat_channels/ has been returning stale data. It has been decided to officially deprecate this route, meaning that it will be labelled as "legacy" and start returning deprecation headers. This endpoint will then be removed completely on May 18th, 2018. When will chat channel functionality be returning to ESI? At this point in time there is no ETA on the return of chat functionality in ESI or even what form it will take. All that is known is that it will look radically different than it did with /v1/characters/{character_id}/chat_channels/. You can be sure that once we know what the future of EVE chat will look like for third party developers that it will be announced here on this blog, so keep your eyes peeled! ... read more
Apr
9

ESI March News

CCP Falcon | 2018-04-09 09:26
This blog post is part of a series of blogs examining best practices for ESI development. Each blog will be published on the 8th of each month during the journey towards XML API and CREST’s termination date. The legacy APIs will be terminated on May 8th, 2018. March has been a busy month for ESI so this blog will cover all the ESI news relevant to third party developers from the previous month. A/B Testing As some of you may know if you follow our twitter or participate in the #esi slack channel, ESI began proxying a percentage of requests from its current cloud provider (Google Cloud) to its new cloud provider (Amazon AWS) on March 27th. The decision to migrate to AWS through means of A/B testing was ... read more
Mar
8

Using ESI With Google Sheets

Team Tech Co | 2018-03-08 18:28
This blog post is part of a series of blogs examining best practices for ESI development. Each blog will be published on the 8th of each month during the journey towards XML API and CREST’s termination date. The legacy APIs will be terminated on May 8th, 2018. Come May 8th, the death of the XML API will also mean the death of many EVE based spreadsheets. Luckily, with the help of community member Blacksmoke16's GESI, the process for making an ESI based Google Sheet is much more simple than it has ever been. This blog will walk through how to make a Google Sheet to track your character's in-game assets using authenticated calls with GESI without needing to write any code yourself. Creating a Google sheet and adding GESI Go ... read more
Feb
9

Upwell 2.0 ESI Structure Changes

CCP Guard | 2018-02-09 16:48
Upwell 2.0 ESI Structure Changes Greetings developers! If you've been watching our dev blogs you'll know that there are some upcoming changes to structures coming on February 13th. This blog will serve as a short summary of the changes that affect ESI and how ESI is going to accommodate those changes. These structure changes will also be the catalyst for the removal of two CREST routes. ESI changes to expect on February 13th Before jumping into the details of what is changing in game and in ESI, it is best to give a higher level view of which ESI routes are affected and how these changes will be handled. There are two ESI routes affected by these structure changes: GET /corporations/{corporation_id}/structures/ PUT ... read more
Feb
8

Explore EVE's Data Using the ESI UI

Team Tech Co | 2018-02-08 13:34
Explore EVE's Data Using the ESI UI This blog post is part of a series of blogs examining best practices for ESI development. Each blog will be published on the 8th of each month during the journey towards XML API and CREST’s termination date. The legacy APIs will be terminated on May 8th, 2018. Quick update on ESI Before jumping into the meat of this blog, it's important to direct your attention to a new addition to the esi-issues Github repository. With help from our community, a document detailing what constitutes a breaking change (and therefore a version bump) has been written up. In previous blogs (found here and here) we have presented how versioning is done in ESI. However, we never had a solid set of rules stating what constitutes a version ... read more