Troubleshooting

Troubleshooting

InvalidApiKeyException

The client received an empty key or the placeholder YOUR-API-KEY.

• verify STEAM_API_KEY;
• refresh Laravel's configuration cache;
• confirm the key is passed to manually constructed clients;
• never print the key while debugging.

php artisan config:clear
php artisan config:cache

HTTP 401 or 403

Possible causes:

• invalid or revoked key;
• publisher endpoint called with a normal key;
• key is not associated with the requested app;
• profile or resource permissions prevent access.

Do not solve permission failures by exposing a publisher key to the client.

Empty games, friends or achievements

The profile may be private, Steam may omit fields, or the key may lack app access. See Profile privacy.

UnrecognizedId

The supplied Steam ID cannot be normalized. Use a supported Steam64, Steam2 or Steam3 value. Vanity names must be resolved first. See Steam ID guide.

ApiCallFailedException

Inspect the exception code and previous throwable:

catch (ApiCallFailedException $exception) {
    logger()->warning('Steam request failed', [
        'status' => $exception->getCode(),
        'error' => $exception->getMessage(),
    ]);
}

Ensure logs do not contain full request URLs with API keys.

Laravel cannot resolve Client

Use the current namespace:

use TeemoCell\SteamWebApi\Client;

Then regenerate Composer autoloading and clear Laravel caches:

composer dump-autoload
php artisan optimize:clear

Wiki or README examples differ from installed code

Confirm the installed package version and compare it with the documentation's latest release. Development-branch documentation may describe unreleased changes.