SaidIt App Development Guidelines
SaidIt and Reddit
SaidIt is not Reddit! This document will help you to understand the differences that pertain to apps and clients.
Home page
- Due to SaidIt's configurable home page feature, requesting https://saidit.net/top returns content from an unknown sub! It could be /s/all or /s/home or /s/subscribed especially if users are logged into your app/client.
- Instead, request 'Home' content from /s/home, 'Subscribed' content from /s/subscribed, and 'All' content from /s/all
- Aka hardcode all sub paths
Voting
- Voting directions
- Reddit: upvote 1, downvote -1, unvote 0
- SaidIt: insightful vote 1, unvote insightful 11, funny vote -1, unvote funny -11
- Vote counts
- Currently not implemented, only score is available, see known issues below
Type Prefixes
- Reddit: t1_ comment, t2_ account, t3_ post, t4_ message, t5_ subreddit
- SaidIt: t1_ comment, t2_ account, t3_ award, t4_ subreddit, t5_ link, t6_ message, t7_ promocampaign, t8_ globalban, t9_ ipban
API Response Codes
- 429 Too many requests: (nginx) rate limiting has blocked your request. Your app should not send excessive parallel API requests or should wait longer between requests.
- 503 Service Unavailable: SaidIt is down or your request took too long or your request caused an internal error
Known API Issues
- The API should return 'ups' and 'downs' like old Reddit. Currently 'score' is returned in 'ups' and 0 is returned in 'downs'
- GitHub issue: https://github.com/libertysoft3/saidit/issues/19
- Comments API results potentially already updated
- RES breakage?
- RedReader breakage?
API Documentation
- API urls: saidit.net, oauth.saidit.net
- API documentation: https://saidit.net/dev/api
- OAuth guide: https://github.com/libertysoft3/saidit/wiki/OAuth2
revision by — view source