We’ve recently updated some key areas of our developer docs today. The changes include:
Expanded documentation on storing data using state. This includes information about some of the gotchyas with state, and how to use atomicState to address those.
Cleaned up the landing page and Overview sections to be more readable.
Refactored the “Implementation” section into a 2-part tutorial. Part 1 walks you through building a simple Web Services SmartApp, and uses curl to hit those endpoints. Part 2 builds an external application using Sinatra, that shows going through the OAuth2 flow programtically.
We hope you find the updated content useful! (and if you don’t, let us know)
@schettj I want to. I really, really do! But… priorities
BUT - if you (or anyone else) wants to create a Node version, we can try to incorporate it into the docs (or at least link to the source for a Node example)!
Anything specific you want to know? Or just want it, ya know, just want it doc’d at all
Our plan for the next few weeks is to try and doc as much as we can around the new v2/UX stuff that has developer impact. Not sure if we have much bandwidth to fit other stuff in, but if you have a specific question, maybe we can help or get it doc’d quick…
Not at all, that’s why it’s there - I needed to stop being lazy and do that for some other project anyway - just made a clean sample version for anyone else wandering down this rabbit hole
I don’t know what I don’t know, so I can’t be specific. We aren’t allowed to do a getClass() in the IDE, so lots of useful methods such as getTemperatureScale() instead of doing a location.temperatureScale are hidden from the developers.
Some of those functions are found in device types & smartapp examples and it’s kinda hard to find one out by going through a lot of those examples. I’d be nice to know so developers don’t have to spend too much time developing a custom method.
4 Likes
tgauchat
(ActionTiles.com co-founder Terry @ActionTiles; GitHub: @cosmicpuppy)
15
Also would be extremely handy to have a link to the entire white list of importable classes, please.
@Jim, does SmartThings process the revocation of access tokens? The examples and docs don’t mention it, but I’m guessing they do since that’s a core part of oauth?
If so, perhaps a code snippet on that would be useful…
Currently a long-living token (50 years) is issued, and no refresh token. That may be something that changes in the future, but as of right now, you get a token with a very long expiration (and no refresh token).
Long time ago, when createAccessToken() was called, it would invalidate any existing access tokens. Now it just creats additional ones. There is no apparent way to invalidate an access token.
Now, can you do it in Node.js? 
