Merge branch 'master' of https://github.com/ajayyy/SponsorBlockServer into experimental

This commit is contained in:
Ajay Ramachandran
2019-09-16 17:08:00 -04:00

View File

@@ -16,6 +16,16 @@ Hopefully this project can be combined with projects like [this](https://github.
The client web browser extension is available here: https://github.com/ajayyy/SponsorBlock The client web browser extension is available here: https://github.com/ajayyy/SponsorBlock
# Build At Home
This is a node.js server, so clone this repo and run `npm install` to install all dependencies.
Make sure to create the databases in the `databases` folder out of the database schemas.
Rename `config.json.example` to `config.json` and fill the parameters inside.
Run the server with `npm start`.
# API Docs # API Docs
Public API available at https://sponsor.ajay.app. Public API available at https://sponsor.ajay.app.
@@ -150,7 +160,9 @@ __________________________________________________________________
``` ```
{ {
userID: string, userID: string,
userName: string userName: string,
//optional
adminUserID: string //This is if you want to change someone elses username from the admin account
} }
``` ```
@@ -238,3 +250,81 @@ __________________________________________________________________
**Error codes**: **Error codes**:
None None
__________________________________________________________________
**GET** `/api/getDaysSavedFormatted`
**Input**:
```
{
Nothing
}
```
**Response**:
```
{
daysSaved: float (2 decimal places)
}
```
**Error codes**:
None
__________________________________________________________________
### Admin Calls
These can only be called by the server administrator, set in the config.
**POST** `/api/shadowBanUser`
Shadow banned submissions are hidden for everyone but the IP that originally submitted it. Shadow banning a user shadow bans all future submissions.
**Input**:
```
{
userID: string, //public userID of the user you want to shadowBan
adminUserID: string, //your userID as an admin
enabled: boolean, //optional, to be able to add and remove users
unHideOldSubmissions: boolean //optional, should all previous submissions be banned as well?
}
```
**Response**:
```
{
Nothing (status code 200)
}
```
**Error codes**:
400: Bad Request (Your inputs are wrong/impossible)
403: Unauthorized (You are not an admin)
__________________________________________________________________
**POST** `/api/addUserAsVIP`
VIPs have extra privileges and their votes count more.
**Input**:
```
{
userID: string, //public userID of the user you want to add to the VIP list
adminUserID: string, //your userID as an admin
enabled: boolean //optional, to be able to add and remove users
}
```
**Response**:
```
{
Nothing (status code 200)
}
```
**Error codes**:
400: Bad Request (Your inputs are wrong/impossible)
403: Unauthorized (You are not an admin)