-
Notifications
You must be signed in to change notification settings - Fork 19
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
7b83f60
commit 5f9b1b9
Showing
1 changed file
with
77 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,77 @@ | ||
# steamstore | ||
|
||
A module for interacting with the Steam store site from node.js. Currently it only manages adding and removing phone | ||
numbers. | ||
|
||
## Logging In | ||
|
||
This module cannot facilitate logins to the store site directly. You'll need to use something like | ||
[`node-steam-user`](https://www.npmjs.com/package/steam-user) or | ||
[`node-steamcommunity`](https://www.npmjs.com/package/steamcommunity) to login, and then use | ||
[`setCookies`](#setcookiescookies) to set your login cookies in this module. | ||
|
||
The cookies are the same for the store site and for the community site. | ||
|
||
# Methods | ||
|
||
### Constructor() | ||
|
||
Constructs a new instance of `steamstore`. Example: | ||
|
||
```js | ||
var SteamStore = require('steamstore'); | ||
var store = new SteamStore(); | ||
``` | ||
|
||
### setCookie(cookie) | ||
- `cookie` - The cookie, in "name=value" string format | ||
|
||
Sets a single cookie to `steamstore`'s internal cookie jar. | ||
|
||
### setCookies(cookies) | ||
- `cookies` - An array of cookies, in "name=value" string format | ||
|
||
Simply calls [`setCookie`](#setcookiecookie) for each cookie in the array. | ||
|
||
### getSessionID() | ||
|
||
Returns the value of the `sessionid` cookie, or creates a new random one and adds it to the cookie jar if not present. | ||
|
||
### addPhoneNumber(number[, bypassConfirmation], callback) | ||
- `number` - Your phone number, with a leading plus and the country code | ||
- Example: `+18885550123` | ||
- `bypassConfirmation` - `true` if you want to ignore any confirmation-level errors (see below). Default `false` | ||
- `callback` - A function to be called when the request completes | ||
- `err` - An `Error` object on failure, or `null` on success. The `confirmation` property will be `true` if this is | ||
a confirmation-level error which can be overridden by setting `bypassConfirmation` to `true` | ||
|
||
Adds a new phone number to your account. This triggers a verification SMS to be sent. You can provide the verification | ||
code to [`verifyPhoneNumber`](#verifyphonenumbercode-callback) to finalize the process. | ||
|
||
### resendVerificationSMS(callback) | ||
- `callback` - A function to be called when the request completes | ||
- `err` - An `Error` object on failure, or `null` on success | ||
|
||
Asks the Steam servers to resend the verification SMS to your pending-confirmation phone number. This will fail if you | ||
request it too soon after the last SMS was sent. | ||
|
||
### verifyPhoneNumber(code, callback) | ||
- `code` - Your SMS verification code | ||
- `callback` - A function to be called when the request completes | ||
- `err` - An `Error` object on failure, or `null` on success | ||
|
||
Verify your pending-verification phone number using the SMS code. | ||
|
||
### removePhoneNumber(callback) | ||
- `callback` - A function to be called when the request completes | ||
- `err` - An `Error` object on failure, or `null` on success | ||
|
||
Starts the process to remove your phone number from your account. This will send an SMS verification code to your phone. | ||
Call [`confirmRemovePhoneNumber`](#confirmremovephonenumbercode-callback) with the code to finalize the process. | ||
|
||
### confirmRemovePhoneNumber(code, callback) | ||
- `code` - Your SMS verification code | ||
- `callback` - A function to be called when the request completes | ||
- `err` - An `Error` object on failure, or `null` on success | ||
|
||
Finalizes the process of removing your phone number from your account. |