Skip to content
/ nodeSteam Public
forked from Tidwell/nodeSteam

node.js implementation of the Steam/TF2 Web API

License

Notifications You must be signed in to change notification settings

borm/nodeSteam

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

node-steam

A node.js wrapper for Valve's Steam Web API. Also supports the methods provided for TF2/TF2Beta/Portal.

Use of the API requires an API key, obtainable here.

This implementation is not supported, endorsed, or created by Valve - I'm just a fan. This is just a wrapper - all of Valve's terms and conditions for using their API still apply, see the Steam community developer page for additional information.

Installation

npm install steam-web

Methods

All methods accept a single options object. The key names match the query string parameters specified in the valve documentation. (Additional docs coming soon. For now, see usage and the valve documentation for any questions).

If using JSON for results (default), the result will automatically be parsed into a json object before being passed to the callback. Any other formats will return the raw data (xml or vdf).

####getNewsForApp

####getGlobalAchievementPercentagesForApp

####getPlayerSummaries

####getFriendList

####getSchema

####getPlayerItems

####getAssetPrices

####getAssetClassInfo

Usage

var steam = require('steam-web');

var s = new steam({
  apiKey: 'XXXXXXXXXXXXXXXX',
  format: 'json' //optional ['json', 'xml', 'vdf']
});

s.getNewsForApp({
  appid: 440,
  count: 3,
  maxlength: 300,
  callback: function(err, data) {
    console.log(data);
  }
})
s.getGlobalAchievementPercentagesForApp({
  gameid: 440,
  callback: function(err, data) {
    console.log(data);
  }
});
s.getPlayerSummaries({
  steamids: ['76561198037414410', '76561197960435530'],
  callback: function(err, data) {
    console.log(data);
  }
})
s.getFriendList({
  steamid: '76561197960435530',
  relationship: 'all', //'all' or 'friend'
  callback: function(err,data) {
    console.log(data);
  },
})
s.getSchema({
  gameid: 440,
  callback: function(err, data) {
    console.log(data);
  }
})
s.getPlayerItems({
  gameid: 440,
  steamid: '76561197960435530',
  callback: function(err, data) {
    console.log(data);
  }
})
s.getAssetPrices({
  appid: 440,  //can also use gameid instead for convenience
  callback: function(err,data) {
    console.log(data);
  }
})

There are two ways to use getAssetClassInfo.  By default, the Steam API
wants a query string formatted as: ?classid0=1234&classid1=5678&class_count=2

As such, you can either manually generate the keys and call the method like this:

s.getAssetClassInfo({
  appid: 440, //can also use gameid instead for convenience
  classid0: '16891096',
  classid1: 151,
  class_count: 2,
  callback: function(err,data) {
    console.log(data);
  }
})

OR, I've provided a convenience property so you can just pass an array of ids
(when using the convenience property, you don't need to pass class_count either)

s.getAssetClassInfo({
  appid: 440, //can also use gameid instead for convenience
  classIds: ['16891096',151],
  callback: function(err,data) {
    console.log(data);
  }
})

Changes

####0.2.1

####0.1.3

  • Implemented new API methods from 12/1/2011 update: getAssetClassInfo, getAssetPrices, and getFriendList
  • Fixed bug where callbacks were fired twice for certain error events
  • Added convenience property to getAssetClassInfo (classIds instead of forcing manual property generation)

####0.1.2

  • Changed requirements to node >= 0.4.0
  • Modified API so first argument of all callbacks is err (to correspond with standard practices)
  • Additional error handling (though methods will return empty arrays if invalid ids are sent to steam

About

node.js implementation of the Steam/TF2 Web API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published