More actions
Add link to dev blog. |
Remove relative time reference. Apply QuillBot tips (https://quillbot.com/grammar-check). See UniWiki:Manual of Style/Words to watch#Relative time references |
||
| (5 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
EVE | EVE Stable Infrastructure (ESI) is an API that can be used by [[Third-party tools|third party applications]] to interact with data from the EVE game servers. It replaces CREST and the XML API which were shut down on May 8th, 2018.<ref>Dev insights blog: [https://developers.eveonline.com/blog/article/important-information-on-the-future-of-the-eve-api Important Information on the Future of the EVE API] (2018-01-03)</ref> The data returned by ESI is in the JSON format. | ||
ESI has both public-data and authenticated endpoints, the latter of which require a character to log in via [[EVE SSO]] to their character account to gain access to information specific to their character or, provided they have the appropriate [[Managing corporation members#List of roles|corporate role]], their corporation. | ESI has both public-data and authenticated endpoints, the latter of which require a character to log in via [[EVE SSO]] to their character account to gain access to information specific to their character or, provided they have the appropriate [[Managing corporation members#List of roles|corporate role]], their corporation. | ||
| Line 86: | Line 86: | ||
== Tips & Tricks == | == Tips & Tricks == | ||
ESI endpoints use a Token system for rate limiting [https://smudge.ai/blog/ratelimit-algorithms#sliding-windows Tokens on a Sliding Window refresh] - each hit on an endpoint uses up a token, and if attempted too often (usually at a rate faster than the cache time of the endpoint), the caller will be limited until the next window refresh passes and tokens are returned. | |||
More information on the rate limiting can be found in the [https://developers.eveonline.com/docs/services/esi/rate-limiting/ documentation]. | |||
Eve uses a lot of 'ID's, that are unique for things. Ships, players, corporations, systems all have unique IDs. Most IDs are arranged in 'Ranges' as well. Comparing IDs against these ranges to find out what type of ID it is. https://developers.eveonline.com/docs/guides/id-ranges/ has these ranges listed out. Figuring out what an ID is can answer many questions of what ESI to find out what it is. There are two very fast ways to find Names for IDs as well. Linking a thing in chat, then hit enter, then right click, and copy. This will put the URL code in the clipboard. Alternately, go to a site like https://zkillboard.com/ and the ID will be at the end. Ex: https://zkillboard.com/ship/22460 the Eris id is 22460. See also [[How to get ID]] | Eve uses a lot of 'ID's, that are unique for things. Ships, players, corporations, systems all have unique IDs. Most IDs are arranged in 'Ranges' as well. Comparing IDs against these ranges to find out what type of ID it is. https://developers.eveonline.com/docs/guides/id-ranges/ has these ranges listed out. Figuring out what an ID is can answer many questions of what ESI to find out what it is. There are two very fast ways to find Names for IDs as well. Linking a thing in chat, then hit enter, then right click, and copy. This will put the URL code in the clipboard. Alternately, go to a site like https://zkillboard.com/ and the ID will be at the end. Ex: https://zkillboard.com/ship/22460 the Eris id is 22460. See also [[How to get ID]] | ||
| Line 120: | Line 122: | ||
== Patch History == | == Patch History == | ||
{{expansion past| | {{expansion past| | ||
'''03.02 | '''2025.03.02''' - Dev insights blog: [https://developers.eveonline.com/blog/deprecation-and-impending-removal-of-esi-opportunities-and-esi-bookmarks Deprecation and impending removal of esi-opportunities and esi-bookmarks] | ||
* The bookmark endpoints has been removed after being disabled for more than 5 years<ref>Dev insights blog: [https://developers.eveonline.com/blog/article/temporary-blackout-of-esi-bookmarks Temporary blackout of ESI-bookmarks] (2019-11-24)</ref>. | * The bookmark endpoints has been removed after being disabled for more than 5 years<ref>Dev insights blog: [https://developers.eveonline.com/blog/article/temporary-blackout-of-esi-bookmarks Temporary blackout of ESI-bookmarks] (2019-11-24)</ref>. | ||
* The opportunities endpoints have been removed. | * The opportunities endpoints have been removed. | ||
'''2025.10.17''' | |||
* Rate Limiting in the form of Tokens was added <ref> Dev insights blog: [https://developers.eveonline.com/blog/hold-your-horses-introducing-rate-limiting-to-esi Hold your horses: introducing rate limiting to ESI] (2025-10-17)</ref> | |||
}} | }} | ||