Adding Swagger API docs + api improvements/fixes

[jasoncalabrese]

No description provided.

[codecov-io]

Current coverage is 82.72%

Merging #856 into dev will decrease coverage by -0.03% as of 3c53143

@@              dev    #856   diff @@
=====================================
  Files          59      59       
  Stmts        3973    3966     -7
  Branches        0       0       
  Methods         0       0       
=====================================
- Hit          3288    3281     -7
  Partial         0       0       
  Missed        685     685       

Review entire Coverage Diff as of 3c53143

---

Uncovered Suggestions

1. +0.36% via lib/mqtt.js#128...141
2. +0.31% via lib/mqtt.js#292...303
3. +0.31% via .../js/profileeditor.js#323...334
4. See 7 more...

Powered by Codecov. Updated on successful CI builds.

[bewest]

LGTM 🚢