Platform: Reddit

Set up the platform

Create a new App in your Reddit account

go to https://www.reddit.com/prefs/apps
create an app ('script')
- redirect url with host/port from your .env (http://localhost:8000/callback)
note the code and secret in your app box
- save as FAIRPOST_REDDIT_CLIENT_ID in your global .env
- save as FAIRPOST_REDDIT_CLIENT_SECRET in your global .env
read the terms here https://www.reddit.com/wiki/api/#wiki_read_the_full_api_terms_and_sign_up_for_usage
request access to the API using the request form, and wait until approved

Connect the platform to a user

Enable the platform

Add 'reddit' to your FAIRPOST_FEED_PLATFORMS in your users storage.json

Get an OAuth2 Access Token for your Reddit account

This token only lasts for 24 hours and should be refreshed.

call ./fairpost.js @userid setup-platform --platform=reddit
follow instructions from the command line

Test the platform

call ./fairpost.js @userid test-platform --platform=reddit

More user settings

REDDIT_PLUGIN_SETTINGS - a json object describing / overwriting the plugins used to prepare posts

Random documentation

https://www.reddit.com/r/test/

https://www.reddit.com/prefs/apps

https://www.reddit.com/wiki/api/#wiki_read_the_full_api_terms_and_sign_up_for_usage

duration permanent -> refresh scope submit

https://github.com/reddit-archive/reddit/wiki/OAuth2

GET https://www.reddit.com/api/v1/authorize?client_id=CLIENT_ID&response_type=TYPE& state=RANDOM_STRING&redirect_uri=URI&duration=DURATION&scope=SCOPE_STRING

POST https://www.reddit.com/api/v1/access_token grant_type=authorization_code&code=CODE&redirect_uri=URI Authorization: Basic Auth (client_id:client_secret) { "access_token": Your access token, "token_type": "bearer", "expires_in": Unix Epoch Seconds, "scope": A scope string, "refresh_token": Your refresh token }