public static function Update($keyID, $vCode)
{
// Start and validate they key pair
BaseApi::bootstrap();
BaseApi::validateKeyPair($keyID, $vCode);
$scope = 'Account';
$api = 'APIKeyInfo';
// Prepare the Pheal instance
$pheal = new Pheal($keyID, $vCode);
// Do the actual API call. pheal-ng actually handles some internal
// caching too.
try {
$key_info = $pheal->accountScope->APIKeyInfo();
} catch (\Pheal\Exceptions\APIException $e) {
// Some API responses require some rather important actions
// SeATs perspective. For eg. Expired keys, IP bans, rate
// limits etc. As APIKeyInfo is probably one of the
// most called eveapi Updater, we will add the
// logic here to check for these types of
// responses.
// Source: https://api.eveonline.com/Eve/ErrorList.xml.aspx
switch ($e->getCode()) {
// "API key authentication failure."
case 202:
// "Authentication failure."
// "Authentication failure."
case 203:
case 204:
// "Authentication failure."
// "Authentication failure."
case 205:
// "Authentication failure."
// "Authentication failure."
case 210:
// "Authentication failure (final pass)."
// "Authentication failure (final pass)."
case 212:
// The API is probably entirely wrong.
BaseApi::disableKey($keyID, $e->getCode() . ': ' . $e->getMessage());
return;
// "Invalid Corporation Key. Key owner does not fullfill role
// requirements anymore."
// "Invalid Corporation Key. Key owner does not fullfill role
// requirements anymore."
case 220:
// Owner of the corporation key doesnt have hes roles anymore?
BaseApi::disableKey($keyID, $e->getCode() . ': ' . $e->getMessage());
return;
// "Illegal page request! Please verify the access granted by the key you are using!."
// "Illegal page request! Please verify the access granted by the key you are using!."
case 221:
// Not 100% sure how to handle this one. This call has no
// access mask requirement...
return;
// "Key has expired. Contact key owner for access renewal."
// "Key has expired. Contact key owner for access renewal."
case 222:
// We have a invalid key. Expired or deleted.
BaseApi::disableKey($keyID, $e->getCode() . ': ' . $e->getMessage());
return;
// "Authentication failure. Legacy API keys can no longer be
// used. Please create a new key on support.eveonline.com
// and make sure your application supports Customizable
// API Keys."
// "Authentication failure. Legacy API keys can no longer be
// used. Please create a new key on support.eveonline.com
// and make sure your application supports Customizable
// API Keys."
case 223:
// The API we are working with is waaaaaay too old.
BaseApi::disableKey($keyID, $e->getCode() . ': ' . $e->getMessage());
return;
// "Web site database temporarily disabled."
// "Web site database temporarily disabled."
case 901:
// The EVE API Database is apparently down, so mark the
// server as 'down' in the cache so that subsequent
// calls don't fail because of this.
\Cache::put('eve_api_down', true, 30);
return;
// "EVE backend database temporarily disabled.""
// "EVE backend database temporarily disabled.""
case 902:
// The EVE API Database is apparently down, so mark the
// server as 'down' in the cache so that subsequent
// calls don't fail because of this.
\Cache::put('eve_api_down', true, 30);
return;
// "Your IP address has been temporarily blocked because it
// is causing too many errors. See the cacheUntil
// timestamp for when it will be opened again.
// IPs that continually cause a lot of errors
// in the API will be permanently banned,
// please take measures to minimize
// problematic API calls from your
// application."
// "Your IP address has been temporarily blocked because it
// is causing too many errors. See the cacheUntil
// timestamp for when it will be opened again.
// IPs that continually cause a lot of errors
// in the API will be permanently banned,
// please take measures to minimize
// problematic API calls from your
// application."
case 904:
// If we are rate limited, set the status of the eveapi
// server to 'down' in the cache so that subsequent
// calls don't fail because of this.
// Get time of IP ban in minutes, rounded up to the next whole minute
$time = round(($e->cached_until_unixtime - $e->request_time_unixtime) / 60, 0, PHP_ROUND_HALF_UP);
\Cache::put('eve_api_down', true, $time);
return;
// We got a problem we don't know what to do with, so log
// and throw the exception so that the can debug it.
// We got a problem we don't know what to do with, so log
// and throw the exception so that the can debug it.
default:
\Log::error('Call to APIKeyInfo for ' . $keyID . ' failed with: ' . $e->getCode() . ':' . $e->getMessage(), array('src' => __CLASS__));
throw $e;
break;
}
// Process a ban request as needed
BaseApi::banCall($api, $scope, $keyID, 0, $e->getCode() . ': ' . $e->getMessage());
return;
} catch (\Pheal\Exceptions\PhealException $e) {
throw $e;
}
// Check if the data in the database is still considered up to date.
// checkDbCache will return true if this is the case
if (!BaseApi::checkDbCache($scope, $api, $key_info->cached_until, $keyID)) {
$key_data = \EveAccountAPIKeyInfo::where('keyID', '=', $keyID)->first();
if (!$key_data) {
$key_data = new \EveAccountAPIKeyInfo();
}
$key_data->keyID = $keyID;
$key_data->accessMask = $key_info->key->accessMask;
$key_data->type = $key_info->key->type;
$key_data->expires = strlen($key_info->key->expires) > 0 ? $key_info->key->expires : null;
// hack much?
$key_data->save();
// Check if we have any knowledge of any characters for this key. We will remove values from this
// array as we move along to determine which characters we should delete that are possibly no
// longer on this key
$known_characters = array();
foreach (\EveAccountAPIKeyInfoCharacters::where('keyID', '=', $keyID)->get() as $character) {
$known_characters[] = $character->characterID;
}
$known_characters = array_flip($known_characters);
// Update the key characters
foreach ($key_info->key->characters as $character) {
// Check if we need to update || insert
$character_data = \EveAccountAPIKeyInfoCharacters::where('keyID', '=', $keyID)->where('characterID', '=', $character->characterID)->first();
if (!$character_data) {
$character_data = new \EveAccountAPIKeyInfoCharacters();
}
// else, add/update
$character_data->characterID = $character->characterID;
$character_data->characterName = $character->characterName;
$character_data->corporationID = $character->corporationID;
$character_data->corporationName = $character->corporationName;
$key_data->characters()->save($character_data);
// Remove this characterID from the known_characters as its still on
// the key
if (array_key_exists($character->characterID, $known_characters)) {
unset($known_characters[$character->characterID]);
}
}
// Delete the characters that are no longer part of this key
foreach (array_flip($known_characters) as $oldcharacter) {
\EveAccountAPIKeyInfoCharacters::where('keyID', '=', $keyID)->where('characterID', '=', $oldcharacter)->delete();
}
// Update the cached_until time in the database for this api call
BaseApi::setDbCache($scope, $api, $key_info->cached_until, $keyID);
}
return $key_info;
}