Skip to content

Latest commit

 

History

History
170 lines (100 loc) · 4.64 KB

_smart_app_d_.smartappoptions.md

File metadata and controls

170 lines (100 loc) · 4.64 KB

SmartAppSmartAppOptions

SmartAppOptions

Properties

Optional apiUrl

apiUrl? : string

Specify an alternate base URL for SmartThings API calls. This value is only necessary for testing new API versions or non-production environments.


Optional appId

appId? : string

The App.appId or unique App.appName field of your SmartApp. This field is necessary for any app that requires permissions in addition to those implied by the app configuration settings.


Optional clientId

clientId? : string

The client id used to refresh expired tokens


Optional clientSecret

clientSecret? : string

The client secret used to refresh expired tokens


Optional disableCustomDisplayName

disableCustomDisplayName? : boolean

Disables the ability for users to rename the installed app instance in the configuration page. This may be desirable for singleton apps that can only be installed once per location. Apps that can be installed multiple times per location should not disable renaming, or the result will be multiple apps with the same name.


Optional disableRemoveApp

disableRemoveApp? : boolean

Disables the button that allows users to remove the app from the configuration page.


Optional enableEventLogging

enableEventLogging? : boolean

Enables logging of all lifecycle events and responses


Optional firstPageId

firstPageId? : string

Sets the initial configuration page to be rendered when an app is installed or updated. If not specified then the first page defined will be rendered.


Optional jsonSpace

jsonSpace? : number

The number of spaces to indent pretty-printed JSON log output. Setting this value to zero disables pretty-printing


Optional keyApiHost

keyApiHost? : string

Specify an alternate key host URL for use in validating request signatures. This value is only necessary for testing new API versions or non-production environments.


Optional keyCacheTTL

keyCacheTTL? : number

Time-to-live of the ST_PADLOCK keys in milliseconds. The default value is 86400000 (24 hours).


Optional logUnhandledRejections

logUnhandledRejections? : boolean

Catch and log any unhandled rejections. Defaults to true


Optional logger

logger? : Logger

Overrides the default Winston event and error logger that writes to the console


Optional permissions

permissions? : string | string[]

List of scopes explicitly required by this app. For example `['r:devices:', and 'x:devices:'] to be able to read and control all devices in the location. Note that you do not have to provide this list for devices selected by the user in configuration settings.


Optional publicKey

publicKey? : string

The public key to be used for signature verification of lifecycle event calls. Not necessary for apps that use ST_PADLOCK signatures.


Optional redirectUri

redirectUri? : string

The OAuth2 redirect uri used for API access integrations to SmartThings


Optional refreshUrl

refreshUrl? : string

Specify an alternate OAuth2 refresh URL for API access apps. This value is only necessary for testing new API versions or non-production environments.