Skip to content
Lukas Niederberger edited this page Dec 31, 2018 · 2 revisions

What is ESI Swagger UI?

This is the v3 (by swagger-ui standards) home of the ESI web UI. This repo exists to allow third party contributions to the UI that powers https://esi.evetech.net/ui

How do I run this?

You can create a local copy of ESI in a few simple steps:

  1. have a working docker host somewhere

  2. make a new application with all the scopes on https://developers.eveonline.com/applications. use http://your-docker-host:8000/ui/oauth2-redirect.html as the callback URL (replace your-docker-host with the actual name or IP of your docker host...)

  3. save your application's client id in a file called client_id

  4. run the run.sh script, go to http://your-docker-host:8000/

How does this differ from production?

In two notable ways:

  1. The index.html is actually jinja2 markup and provided by the esi-router (python). This includes passing the initial version information and client ID, as well as customizable datasources for local/internal development.

  2. The swagger.json's are provided by the ESI routers dynamically. In run.sh we download a local copy of the three specs (latest, legacy and dev) and serve them ourselves. If you want to update your local copies simply delete them and rerun run.sh.