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
|
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)
|
||||||
|
|||||||
Reference in New Issue
Block a user