This service for Element43 handles all (bulk) requests for static data we currently cannot do via ESI. At the moment this is restricted to serving market type's IDs and uniform location data regarding structures/stations, solar systems, constellations and regions, acting as a kind of best-effort (more on that later) caching proxy for external APIs. Typical requests query around 1,000 locations. Location data is fetched from multiple sources, cached in-memory and persisted to disk. This prevents unnecessary requests to external APIs. Depending on the location's ID, different sources and cache exiprations are used:
- Stations, Solar Systems, Constellations, Regions: ESI, 24h expiry
- Conquerable Stations: ESI, 1h expiry
- Structures (citadels...): 3rd Party API, fetched in bulk every hour
Items are not deleted on expiry as the APIs can be flaky or down for extended periods of time. In case a queried entry is expired the proxy tries to retrieve location info for the entry. If the backing API is down, the expired entry is served as a fallback.
Issues can be filed here. Pull requests can be made in this repo.
The service's gRPC description can be found here.
Either use the prebuilt Docker images and pass the appropriate env vars (see below), or:
- Install Go, clone this repo into your gopath
go get ./...to fetch the service's dependencies
bash generateProto.shto generate the necessary gRPC-related code
go buildto build the service
./static-datato start the service
Builds and releases are handled by Drone.
|LOG_LEVEL||info||Threshold for logging messages to be printed|
|PORT||43000||Port for the API to listen on|
|DB_PATH||static-data.db||Path for storing the persistent location cache|
|ESI_HOST||esi.tech.ccp.is||Hostname used for accessing ESI. Change this if you proxy requests.|
|STRUCTURE_HUNT_HOST||stop.hammerti.me.uk||Hostname used for accessing the 3rd party structure hunt API. Change this if you proxy requests.|
|DISABLE_TLS||false||Only check this if you're proxying API requests and terminate TLS-connections at the proxy.|