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; }