A standalone ESI (Eve Swagger Interface) Client Library using kevinrob/guzzle-cache-middleware.
ESI compatibility date: This branch of
esi-clienttargets ESI compatibility date2025-12-16and forward. Responses DTOs are sourced fromseatplus/esi-schema(1.x). If CCP publishes a new breaking compatibility date, a new major version of both packages will be released.
You can install the package via composer:
composer require seatplus/esi-clientThe SDK exposes typed resource methods. Single-object endpoints return the DTO directly (a subclass of AbstractEsiDto); paginated list endpoints return EsiResult<array<T>>.
use Seatplus\EsiClient\EsiClient;
$sdk = new EsiClient();
// Single object — returns AllianceDetail directly
$alliance = $sdk->alliance()->getAlliancesAllianceId(99000006);
echo $alliance->name; // typed readonly string
echo $alliance->ticker;
$alliance->isCachedLoad; // bool — true if served from RFC 7234 cache
// Authenticated endpoint — returns CharactersDetail directly
$character = $sdk->withToken($accessToken)->characters()->getCharactersCharacterId(95725047);
echo $character->name;
// Paginated list — returns EsiResult (pages metadata needed)
$result = $sdk->withToken($accessToken)->assets()->getCharactersCharacterIdAssets(95725047, page: 1);
echo $result->pages; // total pages from X-Pages header
foreach ($result->data as $asset) {
echo $asset->item_id; // typed readonly int
}$esi = new EsiClient();
// make a call — returns EsiResponse
$response = $esi->invoke('get', '/characters/{character_id}/', [
'character_id' => 95725047,
]);
// $response->data — stdClass decoded from the JSON body
// $response->pages — total pages (from X-Pages header, or 1)
// $response->isCachedLoad() — true if served from RFC 7234 cacheESI enforces a 1800-token / 15-minute rolling window (one token consumed per request,
irrespective of response code). esi-client itself does not throttle — rate limiting is
handled by the consumer layer (eveapi) using Laravel Horizon throttle middleware on each
queued job.
If the HTTP client receives a 420 Error Limited response, the request is retried with
exponential backoff as configured on the job.
composer testPlease see CHANGELOG for more information on what has changed recently.
As of today this esi client only supports Laravel Cache Middleware. However Kevinrob/guzzle-cache-middleware supports various others such as:
- Doctrine cache
- Laravel cache
- Flysystem
- PSR6
- WordPress Object Cache
if you plan to use this client with any of these a proper CacheMiddleware would be needed. Same goes to the HTTP client. This client and its cache middleware had been designed to use with Guzzle7 (but you can use it with any PSR-7 HTTP client). Please submit your PR accordingly implementing other HTTP clients.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.