steam-rs 0.5.1

Safe Rust bindings for the Steam Web API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Implements the `GetRecentlyPlayedGames` endpoint.

use serde::{Deserialize, Serialize};
use serde_json::Value;

use crate::{
    errors::{ErrorHandle, PlayerServiceError},
    macros::{do_http, optional_argument},
    steam_id::SteamId,
    Steam, BASE,
};

use super::INTERFACE;

const ENDPOINT: &str = "GetRecentlyPlayedGames";
const VERSION: &str = "0001";

#[derive(Debug, Deserialize, Serialize, Clone)]
pub struct Game {
    pub appid: u32,
    pub name: Option<String>,
    pub playtime_2weeks: Option<u32>,
    pub playtime_forever: u32,
    pub img_icon_url: Option<String>,
    pub img_logo_url: Option<String>,
}

#[derive(Debug, Deserialize, Serialize, Clone)]
pub struct RecentlyPlayedGames {
    pub total_count: u32,
    pub games: Vec<Game>,
}

#[derive(Debug, Deserialize, Serialize)]
struct Response {
    response: RecentlyPlayedGames,
}

impl Steam {
    /// Gets information about a player's recently played games
    ///
    /// # Arguments
    ///
    /// * `steam_id` - The SteamID of the player we're asking about.
    /// * `count` - The number of games to return.
    pub async fn get_recently_played_games(
        &self,
        steam_id: SteamId,
        count: Option<u64>,
    ) -> Result<RecentlyPlayedGames, PlayerServiceError> {
        let query = format!(
            "?key={}&steamid={}{}",
            &self.api_key,
            steam_id,
            optional_argument!(count)
        );
        let url = format!("{}/{}/{}/v{}/{}", BASE, INTERFACE, ENDPOINT, VERSION, query);
        let json = do_http!(url, Value, ErrorHandle, PlayerServiceError::GetOwnedGames);
        let recently_played_games: Response = ErrorHandle!(
            serde_json::from_value(json.to_owned()),
            PlayerServiceError::GetRecentlyPlayedGames
        );
        Ok(recently_played_games.response)
    }
}