SteamModels 1.2.2

.NET models for Steam API entities.

Install-Package SteamModels -Version 1.2.2
dotnet add package SteamModels --version 1.2.2
<PackageReference Include="SteamModels" Version="1.2.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SteamModels --version 1.2.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

SteamModels-DotNet

Build Status
.NET Models for the Steam API. Available on NuGet.

Usage

The Steam API results can be deserialized into the .NET model classes provided by SteamModels.

Example with SteamUser:

public class SteamService
{
    private readonly string _playerDetailsUrl = "http://steamcommunity.com/id/{0}/?xml=1";

    private string _username;

    public SteamUser GetSteamUserDetails(string name)
    {
        HttpClient client = new HttpClient();
        this._username = NormalizeUsername(name);
        var playerDetailsResponse = client.GetStreamAsync(this._username);
        XmlSerializer serializer = new XmlSerializer(typeof(SteamUser));
        SteamUser user = (SteamUser)serializer.Deserialize(playerDetailsResponse.Result);
        return user;
    }

    public string NormalizeUsername(string name)
    {
        return name.Contains("http://") ? name : string.Format(_playerDetailsUrl, name);
    }
}

Example with SteamNews:

public class SteamService
{
    private readonly string _steamAppNewsUrl = "http://api.steampowered.com/ISteamNews/GetNewsForApp/v0002/?appid={0}&maxlength=300&format=json";

    public async Task<SteamNews> GetSteamAppNewsJSON(int appid)
    {
	HttpClient client = new HttpClient();
	var steamnews = await client.GetStringAsync(string.format(this._steamAppNewsUrl, appid));
	SteamNews news = JsonConvert.DeserializeObject<SteamNews>(steamnews);
	return news;
    }
}

Example with SteamUserStats:

public class SteamService
{
    private readonly string _steamUserStatsUrl = "http://api.steampowered.com/ISteamUserStats/GetUserStatsForGame/v0002/?appid={0}&key={1}&steamid={2}&format=json";

    public static SteamUserStats GetStatsForGame(string username)
    {
        HttpClient client = new HttpClient();
        var statsForGameResponse = client.GetStringAsync(string.Format(_steamUserStatsUrl, SteamInfo.Config.gameId, SteamInfo.Config.steamApiKey, username));
        SteamUserStats statsForUser = JsonConvert.DeserializeObject<SteamUserStats>(statsForGameResponse.Result);
        return statsForUser;
    }
}

Example with CSGOPlayerStats, which is a superset of SteamUserStats with specific parsing for some CS:GO stats, like HS%, Accuracy, Top Weapon, Total Kills, etc:

public class SteamService
{
    private readonly string _steamUserStatsUrl = "http://api.steampowered.com/ISteamUserStats/GetUserStatsForGame/v0002/?appid={0}&key={1}&steamid={2}&format=json";

    public static CSGOPlayerStats GetStatsForGame(string username)
    {
        HttpClient client = new HttpClient();
        var statsForGameResponse = client.GetStringAsync(string.Format(_steamUserStatsUrl, 730, SteamInfo.Config.steamApiKey, username));
        CSGOPlayerStats statsForUser = JsonConvert.DeserializeObject<CSGOPlayerStats>(statsForGameResponse.Result);
        return statsForUser;
    }
}

Example with SteamGroup

private static readonly string _groupMembersUrl = "https://steamcommunity.com/gid/{0}/memberslistxml/?xml=1";

public static SteamGroup GetSteamGroup(string groupid)
{
    HttpClient client = new HttpClient();
    var playerDetailsResponse = client.GetStreamAsync(string.Format(_groupMembersUrl, groupid));
    XmlSerializer serializer = new XmlSerializer(typeof(SteamGroup));
    SteamGroup group = (SteamGroup)serializer.Deserialize(playerDetailsResponse.Result);
    return group;
}

SteamModels-DotNet

Build Status
.NET Models for the Steam API. Available on NuGet.

Usage

The Steam API results can be deserialized into the .NET model classes provided by SteamModels.

Example with SteamUser:

public class SteamService
{
    private readonly string _playerDetailsUrl = "http://steamcommunity.com/id/{0}/?xml=1";

    private string _username;

    public SteamUser GetSteamUserDetails(string name)
    {
        HttpClient client = new HttpClient();
        this._username = NormalizeUsername(name);
        var playerDetailsResponse = client.GetStreamAsync(this._username);
        XmlSerializer serializer = new XmlSerializer(typeof(SteamUser));
        SteamUser user = (SteamUser)serializer.Deserialize(playerDetailsResponse.Result);
        return user;
    }

    public string NormalizeUsername(string name)
    {
        return name.Contains("http://") ? name : string.Format(_playerDetailsUrl, name);
    }
}

Example with SteamNews:

public class SteamService
{
    private readonly string _steamAppNewsUrl = "http://api.steampowered.com/ISteamNews/GetNewsForApp/v0002/?appid={0}&maxlength=300&format=json";

    public async Task<SteamNews> GetSteamAppNewsJSON(int appid)
    {
	HttpClient client = new HttpClient();
	var steamnews = await client.GetStringAsync(string.format(this._steamAppNewsUrl, appid));
	SteamNews news = JsonConvert.DeserializeObject<SteamNews>(steamnews);
	return news;
    }
}

Example with SteamUserStats:

public class SteamService
{
    private readonly string _steamUserStatsUrl = "http://api.steampowered.com/ISteamUserStats/GetUserStatsForGame/v0002/?appid={0}&key={1}&steamid={2}&format=json";

    public static SteamUserStats GetStatsForGame(string username)
    {
        HttpClient client = new HttpClient();
        var statsForGameResponse = client.GetStringAsync(string.Format(_steamUserStatsUrl, SteamInfo.Config.gameId, SteamInfo.Config.steamApiKey, username));
        SteamUserStats statsForUser = JsonConvert.DeserializeObject<SteamUserStats>(statsForGameResponse.Result);
        return statsForUser;
    }
}

Example with CSGOPlayerStats, which is a superset of SteamUserStats with specific parsing for some CS:GO stats, like HS%, Accuracy, Top Weapon, Total Kills, etc:

public class SteamService
{
    private readonly string _steamUserStatsUrl = "http://api.steampowered.com/ISteamUserStats/GetUserStatsForGame/v0002/?appid={0}&key={1}&steamid={2}&format=json";

    public static CSGOPlayerStats GetStatsForGame(string username)
    {
        HttpClient client = new HttpClient();
        var statsForGameResponse = client.GetStringAsync(string.Format(_steamUserStatsUrl, 730, SteamInfo.Config.steamApiKey, username));
        CSGOPlayerStats statsForUser = JsonConvert.DeserializeObject<CSGOPlayerStats>(statsForGameResponse.Result);
        return statsForUser;
    }
}

Example with SteamGroup

private static readonly string _groupMembersUrl = "https://steamcommunity.com/gid/{0}/memberslistxml/?xml=1";

public static SteamGroup GetSteamGroup(string groupid)
{
    HttpClient client = new HttpClient();
    var playerDetailsResponse = client.GetStreamAsync(string.Format(_groupMembersUrl, groupid));
    XmlSerializer serializer = new XmlSerializer(typeof(SteamGroup));
    SteamGroup group = (SteamGroup)serializer.Deserialize(playerDetailsResponse.Result);
    return group;
}

Release Notes

Making the SteamGroup a public class and exposing members a list of SteamID64.

Dependencies

This package has no dependencies.

Version History

Version Downloads Last updated
1.2.2 150 3/11/2019
1.2.1 177 9/19/2018
1.2.0 143 8/30/2018
1.1.3 123 8/24/2018
1.1.2 143 8/10/2018
1.1.1 135 8/9/2018
1.1.0 325 5/2/2017
1.0.1 363 4/18/2017
1.0.0 240 4/7/2017