eve online esi

EVE Online ESI (EVE Swagger Interface) is the modern API system used by EVE Online to provide third-party developers with access to game data, replacing the older CREST API. It follows the OpenAPI (Swagger) standard, making it easier to interact with programmatically. Key Features of ESI: RESTful API Uses HTTP methods (GET, POST, etc.) for data retrieval and actions. OAuth2 Authentication Securely authenticates users via SSO (Single Sign-On). Real-Time Data Many endpoints update frequently (e.g., market orders, killmails). Rate Limiting Requests are limited (usually 100-1000 per minute, depending on endpoint). WebSocket Support For subscribing to real-time events (e.g., notifications). Common ESI Use Cases Market Data: Fetch prices, orders, and history. Character/Corporation Info: Access skills, wallet, assets, and industry jobs. Killmails: Retrieve recent kills/losses. Fleet & Warfare: Manage fleets and track sovereignty. Universe Data: Look up solar systems, stations, and structures. Getting Started with ESI Register a Third-Party Application - Go to EVE Developers Portal - Register your app to get Client ID and Secret Key. Authentication (OAuth2 Flow) - Use scopes (e.g., esi-markets.read_market_orders.v1) to request permissions. - Redirect users to EVE SSO for authorization. - Exchange the code for an access_token. Make API Requests - Example (Python, using requests): ESI Endpoints (Latest Version) Base URL: https://esi.evetech.net/latest/ Popular Endpoints: - characters/{character_id}/ Character info. - markets/{region_id}/orders/ Market orders. - killmails/{killmail_id}/ Killmail details. - universe/types/{type_id}/ Item info. - corporations/{corporation_id}/ Corp data. Rate Limits & Caching Rate Limits: Vary by endpoint (check response headers for X-Esi-Error-Limit-Remain). ETag Caching: Use If-None-Match headers to avoid redundant requests. Tools & Libraries ESI Documentation: EVE Swagger UI Python: esi-py, aiohttp for async requests. JavaScript: axios or fetch for web apps. Community Tools: EVE Market Data Relay (EMDR), zkillboard (for killmails). Troubleshooting 403 Forbidden: Missing OAuth scope or expired token. 420 Error: Rate limit exceeded (wait and retry). 503: Server maintenance (check @EVEStatus). Would you like help with a specific ESI integration (e.g., fetching market data, managing fleets)? Let me know!