mirror of
https://github.com/ajayyy/SponsorBlockServer.git
synced 2026-01-02 22:59:10 +03:00
Merge branch 'master' of https://github.com/ajayyy/SponsorBlockServer into experimental
This commit is contained in:
92
README.MD
92
README.MD
@@ -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
|
||||
|
||||
# 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
|
||||
|
||||
Public API available at https://sponsor.ajay.app.
|
||||
@@ -150,7 +160,9 @@ __________________________________________________________________
|
||||
```
|
||||
{
|
||||
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**:
|
||||
|
||||
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)
|
||||
|
||||
Reference in New Issue
Block a user