frtz-core v0.2.0
Usage
const { auth, network } = require("frtz")
!(async () => {
const { SID } = await auth.login({ password: "mypassword" })
const { passive } = await network.getDevices({ SID })
const woke = await network.wake({ UID: passive[0], SID })
})()
Functions
Typedefs
frtz.auth.getNewSession(options) ⇒ Promise.<Session>
get a new challenge token
Kind: global function
Param | Type |
---|---|
options | Object |
options.host | string |
frtz.auth.getLoginToken(options) ⇒ string
get a login token (challenge + password)
Kind: global function
Returns: string - solved challenge
Param | Type |
---|---|
options | Object |
options.password | string |
option.challenge | string |
frtz.auth.getSession(options) ⇒ Promise.<Session>
get session with username and loginToken, expires in 20 minutes unless used
Kind: global function
Param | Type |
---|---|
options | Object |
options.loginToken | string |
options.host | string |
options.username | string |
frtz.auth.checkAuth(options) ⇒ Promise.<boolean>
this makes a request to the region & language page, which seems to be the fastest in terms of response time (~650ms)
Kind: global function
Param | Type | Default |
---|---|---|
options | Object | |
options.SID | string | |
options.host | string | "https://fritz.box" |
frtz.auth.login(options) ⇒ Promise.<session>
Takes password and optionally username and host and returns a logged in session object
Kind: global function
Returns: Promise.<session> - session object
Param | Type | Default |
---|---|---|
options | object | |
options.password | string | |
options.username | string | |
options.host | string | "https://fritz.box" |
frtz.network.getDevices(options) ⇒ Promise.<Object>
Get a list of devices
Kind: global function
Returns: Promise.<Object> - data object containing both online and offline devices
Param | Type | Default | Description |
---|---|---|---|
options | Object | ||
options.SID | string | session ID | |
options.host | string | "https://fritz.box" |
frtz.network.wake(options) ⇒ Promise.<boolean>
Wake a device from sleep (Wake On Lan)
Kind: global function
Param | Type | Default | Description |
---|---|---|---|
options | Object | ||
options.SID | string | session ID | |
options.UID | string | unit ID (device ID) | |
options.host | string | "https://fritz.box" |
Session : Object
A session object
Kind: global typedef
Properties
Name | Type |
---|---|
SID | string |
Challenge | string |
BlockTime | string |
expires | number |
Rights | Object |
Rights.Name | Array.<string> |
Rights.Access | Array.<string> |