/** * Set the API key to authenticate with. * * An API key is required to interact with the Battle.net API services. If * you do not have an API key, you must first go to http://dev.battle.net * and create an account. Once you have created an account and registered * your application with Battle.net, you will be assigned a unique API key * that you can use to make requests to the various API endpoints to * retrieve data. Without an API key, you will not be able to get a valid * response from the API. * @param string $key The API key to authenticate requests with. */ public static function setKey($key) { try { if (!is_string($key)) { $keyVarType = gettype($key); throw new BattleNetAPI_Exception('The method setKey() expects the parameter $key to be a string, ' . $keyVarType . ' given.'); } self::$key = $key; } catch (BattleNetAPI_Exception $exception) { $exception->showMessage(); } }