Skip to main content

OAuth2 Scopes

Quran.Foundations's OAuth 2.0 scopes provide a way to limit the amount of access that is granted to an access token. When requesting an accessing token, clients should also request the scopes they are interested in getting access to. If the APIs are user-related, the user will need to consent to granting access to the scopes your app is requesting first.

Content

ScopeDescription
contentRead Quran.Foundation's non user-related content e.g. Tafsirs, Translations, etc

Bookmarks

ScopeDescription
bookmarkManage your bookmarks
bookmark.readRead your existing bookmarks
bookmark.createCreate a new bookmark
bookmark.updateUpdate your existing bookmark
bookmark.deleteDelete your existing bookmarks

Collections

ScopeDescription
collectionManage your collections list
collection.readRead your existing collections list
collection.createCreate a new collection
collection.updateUpdate your existing collections list
collection.deleteDelete your existing collections list

Reading Sessions

ScopeDescription
reading_sessionManage your reading sessions
reading_session.readSee your latest reading sessions
reading_session.createCreate a new reading session
reading_session.updateUpdate your existing reading sessions
reading_session.deleteDelete your existing reading sessions

Preferences

ScopeDescription
preferenceManage your reading and audio preferences
preference.readSee your current reading and audio preferences
preference.updateUpdate your current reading and audio preferences

Activity Days

ScopeDescription
activity_dayManage your activity days
activity_day.readSee your latest activity days
activity_day.createCreate a new activity day
activity_day.estimateEstimate your reading speed of Ayahs
activity_day.updateUpdate your existing activity days
activity_day.deleteDelete your existing activity days

Goals

ScopeDescription
goalManage your goal
goal.readSee your goal
goal.estimateEstimate your goal's week plan
goal.createCreate a new goal
goal.updateUpdate your existing goal
goal.deleteDelete your existing goal

Streaks

ScopeDescription
streakManage your streak
streak.readSee your streak
streak.updateUpdate your streak

Users

ScopeDescription
userManage your user profile data
user.profile.readRead your user profile data
user.username.readRead your current username

Posts

ScopeDescription
postManage your QuranReflect posts
post.readRead your QuranReflect timeline posts
post.createCreate a new QuranReflect post
post.updateUpdate your QuranReflect posts
post.deleteDelete your QuranReflect posts
post.saveSave QuranReflect posts to your profile
post.likeLike QuranReflect posts
post.reportReport QuranReflect posts

Comments

ScopeDescription
commentManage your QuranReflect post comments
comment.readRead QuranReflect posts' comments
comment.createCreate a new QuranReflect post comment
comment.updateUpdate your QuranReflect post comments
comment.deleteUpdate your QuranReflect post comments

Groups

ScopeDescription
groupManage your QuranReflect groups
group.readRead your QuranReflect groups
group.updateUpdate your QuranReflect groups' settings