Every Setting Example
This SmartApp has multiple configuration pages that contain examples of all setting types.
Start
To get going quickly with this example, we've provided a few options for hosting below. Follow any one of them to get the app up and accepting requests before moving on to registration instructions.
Heroku
View logs in the Heroku dashboard.
Click the Open app button in the Heroku dashboard app page to copy the public URL for use in steps below.
Glitch (no account required)
View logs in the Glitch editor.
Copy the Live Site URL from Glitch for use in steps below.
Local
We recommend using ngrok to create a globally available URL for fast testing.
npm install
npm start
ngrok http 3001
Register
Follow the instructions for registering a SmartApp with the SmartThings platform.
- The following OAuth2 scopes are required.
r:devices:*r:locations:*r:scenes:*
A CONFIRMATION request log should show in the log output of the server once registered. Navigate to this link to verify your domain ownership and enable the app to receive events. This is required for successful installation.
Test
Follow the instructions for testing a SmartApp.
File Structure
- smartapp.js — the SmartApp implementation
- server.js — the Express server that hosts the SmartApp as a webhook
- locales/en.json — English version of the app configuration page text