-
Notifications
You must be signed in to change notification settings - Fork 30
Home
This wiki hopes to document the usages of this library and anything else you might need.
In case you missed it, CCP recently announced and are building a new API for EVE Online called ESI. Primarily, this API will be based on the increasingly popular Open API Specification. Effectively, it will be a REST based API, serializing using json. If you are not sold yet, well then I don't know.
One of the key things that is different in ESI when compared to the old XML based API is how authentication is handled. Previously, you would go and generate an API key pair for use in third party tools. These tools would then use this key pair to make API requests as needed.
In the ESI world, this is slightly different and handled using an implicit OAuth 2.0 specification. This means, you as a developer have to go and register your application with CCP to gain a Client ID and Secret Key. This information is then used to prompt users to login to their EVE Online accounts using SSO. Once logged in, it is possible to request a refresh token (based on the scopes the user accepted) which is finally used to make calls to the new ESI API. This refresh token is valid until the user goes and deletes your applications access to their account.
What this really means for an API consumer, is that you need to get that refresh token before you can make any authenticated ESI calls. Admittedly, its not as easy as it used to be with the old XML api, but not an impossible problem to solve for API consumers.
Eseye includes a small helper that will allow you to easily generate a refresh tokens.
Before you get started with making any API calls, it is highly advisable that you head over to the official Swagger documentation site for ESI. https://esi.tech.ccp.is.