Routes about api

[joshghent]

Ok I've finally added swagger docs so hopefully we can all get cracking on it! 💯

[joshghent]

Ok these are the routes we will make. This will need converting to swagger documentation and add payloads to the post/update routes etc.
All private methods use JWT authentication
Public methods use something else (possibly JWT but the account information will not be needed)

PRIVATE - Create user, update, patch, delete
/user

PRIVATE - Create fiddle, GET fiddles for user
/fiddles

PRIVATE - get single fiddle, update delete
/fiddle/:fiddleid

PUBLIC - Get recent fiddles
/fiddles/recent/:dateRange

PUBLIC - Get most starred
/fiddles/popular/:dateRange

PRIVATE - Toggle Starring a fiddle - jwt auth (this is how we get the user that has starred the fiddle)
/fiddles/:fiddleid/star

PRIVATE - Fork a fiddle
/Fiddles/:fiddleid/fork

PRIVATE - Tag a fiddle
/Fiddles/:fiddleid/tag
Post the tag payload

PRIVATE - Download a fiddle to zip
/Fiddles/:fiddleid/download
Returns URL to S3 bucket or some kind of file upload? Would this be fast enough?

PRIVATE - Screenshot a fiddle
/Fiddles/:fiddleid/screenshot
Integrate with carbon.now.sh and return an image

PRIVATE - Get code-blocks screenshot
/Fiddles/:fiddleid/code-blocks
Return the code blocks image for a fiddle