#eve #esi #eve-online #eve-api

eve_esi

Rust API wrapper for interaction with with EVE Online's ESI

6 releases

new 0.2.5 Nov 14, 2024
0.2.4 Nov 8, 2024
0.1.0 Apr 1, 2024

#2 in #eve

Download history 5/week @ 2024-09-23 376/week @ 2024-11-04

376 downloads per month

MIT license

20KB
416 lines

EVE ESI

Rust API wrapper for interaction with EVE Online's ESI.

Usage

let user_agent = format!("APPLICATION_NAME/1.0 (example@example.com)");
let esi_client = eve_esi::Client::new(&user_agent);

let character_id: i32 = 2114794365;

let character: eve_esi::model::Character = esi_client.get_character(character_id).await.unwrap();

println!(character);

Make certain you set the user agent as demonstrated above, ensure it includes contact email in case there are any issues with your ESI requests.

Examples

See the axum example for a more complete usage demonstration.

To test out the example:

  1. Run cargo run --example axum
  2. Head to one of the URLs posted in your terminal, change the IDs to test out different characters/corporations.

Notes

  • More ESI routes will be added as needed, feel free to submit pull requests to add any you may need.
  • Only public ESI routes are available, private routes will be added at a later date when required by Rust based applications built by Autumn.
  • You can override the esi_url for the ESI Client by simply doing `esi_client.esi_url = "http://your_url.com" for use cases such as unit tests with crates like mockito to emulate endpoints, see this repository's unit tests for an example.

Dependencies

~5–16MB
~211K SLoC