Skip to content

Safe Rust bindings for the Steam Web API

License

Notifications You must be signed in to change notification settings

garhow/steam-rs

Repository files navigation

steam-rs

Crate at crates.io Documentation at docs.rs MIT licensed CI

Provides safe and convenient Rust bindings for the Steam Web API.

Important

As this project is still a work-in-progress, not all API endpoints are currently supported. Most unsupported endpoints require a Steamworks Publisher API key, something that none of the developers of this project currently have. For a list of all supported API interfaces and endpoints, please see ENDPOINTS.md.

Note

This project is in early stages of development, so bug reports, suggestions, and pull requests are highly appreciated!

Usage

use std::env;
use steam_rs::{Steam, SteamId};

#[tokio::main]
async fn main() {
    // Get the Steam API Key as an environment variable
    let steam_api_key = env::var("STEAM_API_KEY").expect("Missing an API key");

    // Initialize the Steam API client
    let steam = Steam::new(steam_api_key);

    // Request the recently played games of SteamID `76561197960434622`
    let steam_id = SteamId::new(76561197960434622);
    let recently_played_games = steam.get_recently_played_games(steam_id, None).await.unwrap();

    // Print the total count of the user's recently played games
    println!("{}", recently_played_games.total_count);
}

Acknowledgements

The following resources were used in the developement in this crate:

Special thanks to @marcohoovy for developing the custom macros and error types used in this project.