This is a Ruby wrapper for the unofficial Xbox API located at http://xboxapi.com

#Installation

gem install xbox-api

One must first create a client that is able to interface with the Xbox API.
The client takes one argument; your xbox API token.

require "xbox-api"
client = XboxApi::Client.new("7ae98726beb982d987e7987ab1239a87")
#=> <XboxApi::Client:0x007fcc9215c8e8>

Using that client, one can then return a Gamer object

logan = client.gamer("oh hai loganz")

The XboxApi::Gamer instance responds to methods that correspond to API endpoints

logan.presence
logan.gamercard

The client also respond to #calls_remaining

client.calls_remaining
#=> {:limit=>"120", :remaining=>"112", :resets_in=>"452"}

You can fetch Xbox game details using either a games title id or game id in hex format

client.game_details(1708767297)

If one already has a gamer's XUID, the API lookup normally required to fetch an XUID during initialization may be skipped by passing in a client instance and the gamer's XUID as the third argument.

client = XboxApi::Client.new(ENV[:XBOX_TOKEN])
logan = XboxApi::Gamer.new("oh hai loganz", client, "189823798746")

The xbl binary may be invoked from the command line.

xbl -s theschoolmaster or xbl --status theschoolmaster may be used to retreive the status of a given player

If you have not yet supplied your API token from XboxApi.com, you will be prompted when trying to use xbl

Additionally, you may clear and set you token with xbl token

# clear your token
xbl token --clear

# set or view your token
xbl token