Model Synchronization and Access¶
EveKit data is updated through a process called model synchronization. During model synchronization, data is retrieved from ESI endpoints and compared to the current live version of various data models. If new data is encountered, or previous data has been removed, then EveKit’s model objects are updated as described in the previous section. EveKit attempts to look for new data at least as frequently as the ESI cache timers allow, and as often as load on the EveKit servers allow. At time of writing, the shortest interval between EveKit updates is 7 minutes. The fastest ESI cache timer is about five seconds (e.g. character location).
Endpoint to Model Data Mapping¶
The following table shows the mapping from ESI endpoint(s) to EveKit model object(s).
ESI endpoint | EveKit Models Updated | Notes |
|
Contacts and contact labels are updated simultaneously during synchronization. | |
|
Assets, their locations and their names are updated simultaneously during synchronization. Note that Location stores both location and name. | |
|
||
|
EveKit does not store a separate bookmark folder object. Instead, bookmark and folder information are combined in the Bookmark object. A consequence is that empty folder names are not stored. This may change in the future. | |
|
Calendar events and their attendees are updated simultaneously during synchronization. | |
|
Contracts, contract items and contract bids (for auctions) are updated simultaneously during synchronization. | |
|
||
|
||
|
Character fleet information including fleet composition is updated simultaneously during synchronization. | |
|
||
|
Kill mail processing is sharded by killmail ID due to size. As a result, several synchronization rounds are necessary to process all recent killmail. At time of writing, 10 rounds are necessary to completely process all recent kill mail. During a round, the sharded kill list and detailed kill information are updated simultaneously. | |
|
||
|
||
|
Mail processing is sharded by mail ID due to size. As a result, several synchronization rounds are necessary to process all mail. At time of writing, 20 rounds are necessary to completely process all mail. During a round, the sharded mail list and detailed mail information are updated simultaneously. Mailing list and mail label processing is not sharded and will be updated in a single synchronization round. | |
|
Market orders and market order history are processed simultaneously during synchronization. | |
|
||
|
||
|
Notifications and contact notifications are processed simultaneously during synchronization. | |
|
||
|
||
|
The planet list and detailed planet information are processed simultaneously during synchronization. | |
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
A character’s skill list and attributes are processed simultaneously during synchronization. | |
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Corporation medals and issued medals are processed simultaneously during synchronization. | |
|
Corporation member list, roles and history of role changes are processed simultaneously during synchronization. | |
|
Corporation member limit and member tracking are processed simultaneously during synchronization. | |
|
Mining extractions, observer list, and observations are processed simultaneously during synchronization. | |
|
||
|
Corporation sheet and icons are processed simultaneously during synchronization. | |
|
Starbase list and starbase details are processed simultaneously during synchronization. | |
|
||
|
Corporation titles, roles and titles assigned to members are processed simultaneously during synchronization. |
Access Permission to Model Data Mapping¶
The following table gives the mapping from EveKit Access Key Permissions to the model data objects which can be retrieved with those permissions.
Permission | Mask | EveKit Models |
Account Status Access | ACCESS_ACCOUNT_STATUS | |
Account Balance Access | ACCESS_ACCOUNT_BALANCE | |
Asset Access | ACCESS_ASSETS | |
Character Sheet Access | ACCESS_CHARACTER_SHEET | |
Corporation Sheet | ACCESS_CORPORATION_SHEET | |
Contact List Access | ACCESS_CONTACT_LIST | |
Blueprint Access | ACCESS_BLUEPRINTS | |
Bookmark Access | ACCESS_BOOKMARKS | |
Contract Access | ACCESS_CONTRACTS | |
Faction War Stats Access | ACCESS_FAC_WAR_STATS | |
Industry Jobs Access | ACCESS_INDUSTRY_JOBS | |
Kill Log Access | ACCESS_KILL_LOG | |
Locations Access | ACCESS_LOCATIONS | |
Market Orders Access | ACCESS_MARKET_ORDERS | |
Mining Ledger Access | ACCESS_MINING_LEDGER | |
Standings Access | ACCESS_STANDINGS | |
Wallet Journal Access | ACCESS_WALLET_JOURNAL | |
Wallet Transactions Access | ACCESS_WALLET_TRANSACTIONS | |
Meta-Data Modification | ALLOW_METADATA_CHANGES | N/A - This mask allows write access to the meta-data map for any model object for which the access key has read access. |
Calendar Event Attendee Access | ACCESS_CALENDAR_EVENT_ATTENDEES | |
Access Chat Channels | ACCESS_CHAT_CHANNELS | |
Access Character Fleets | ACCESS_CHARACTER_FLEETS | |
Access Contact Notifications | ACCESS_CONTACT_NOTIFICATIONS | |
Access Ship Fittings | ACCESS_FITTINGS | |
Access Mail | ACCESS_MAIL | |
Access Mailing Lists | ACCESS_MAILING_LISTS | |
Access Medals | ACCESS_MEDALS | |
Access Notifications | ACCESS_NOTIFICATIONS | |
Access Research | ACCESS_RESEARCH | |
Access Skill Queue | ACCESS_SKILL_QUEUE | |
Upcoming Calendar Event Access | ACCESS_UPCOMING_CALENDAR_EVENTS | |
Container Log Access | ACCESS_CONTAINER_LOG | |
Corporation Medals Access | ACCESS_CORPORATION_MEDALS | |
Member Medals Access | ACCESS_MEMBER_MEDALS | |
Member Security Access | ACCESS_MEMBER_SECURITY | |
Member Security Log Access | ACCESS_MEMBER_SECURITY_LOG | |
Member Tracking Access | ACCESS_MEMBER_TRACKING | |
Shareholder Access | ACCESS_SHAREHOLDERS | |
Starbase List Access | ACCESS_STARBASE_LIST | |
Structure List Access | ACCESS_STRUCTURES | |
Corporation Titles Access | ACCESS_CORPORATION_TITLES |