mirror of
https://github.com/ajayyy/SponsorBlock.git
synced 2025-12-16 16:37:18 +03:00
Updated API Docs (markdown)
34
API-Docs.md
34
API-Docs.md
@@ -17,7 +17,7 @@ Slim Database Mirror (5 min update time, provided by Lartza): https://sb.ltn.fi/
|
||||
<sub>[Database Dump](https://sponsor.ajay.app/database.db) | [Webhook Docs](https://github.com/ajayyy/SponsorBlock/wiki/Webhooks)</sub>
|
||||
________________________________________________________________________________
|
||||
|
||||
**GET** `/api/skipSegments`
|
||||
##### **GET** `/api/skipSegments`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -47,7 +47,7 @@ ________________________________________________________________________________
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**POST** `/api/skipSegments`
|
||||
##### **POST** `/api/skipSegments`
|
||||
|
||||
**Input Option 1 (URL Parameters)**:
|
||||
```js
|
||||
@@ -96,7 +96,7 @@ __________________________________________________________________
|
||||
|
||||
________________________________________________________________________________
|
||||
|
||||
**GET** `/api/skipSegments/:sha256HashPrefix`
|
||||
##### **GET** `/api/skipSegments/:sha256HashPrefix`
|
||||
|
||||
`sha256HashPrefix` is a hash of the YouTube `videoID`. It should be the first 4 - 32 characters (4 is recommended). This provides extra privacy by potentially finding more than just the video you are looking for. This makes the server not know exactly what video you are looking for.
|
||||
|
||||
@@ -131,7 +131,7 @@ ________________________________________________________________________________
|
||||
404: Not Found
|
||||
__________________________________________________________________
|
||||
|
||||
**POST** <sup>or **GET** (legacy)</sup> `/api/voteOnSponsorTime`
|
||||
##### **POST** <sup>or ##### **GET** (legacy)</sup> `/api/voteOnSponsorTime`
|
||||
|
||||
**Input: Normal Vote** (URL Parameters):
|
||||
```js
|
||||
@@ -168,7 +168,7 @@ OR
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**POST** <sup>or **GET** (legacy)</sup> `/api/viewedVideoSponsorTime`
|
||||
##### **POST** <sup>or ##### **GET** (legacy)</sup> `/api/viewedVideoSponsorTime`
|
||||
|
||||
**Input** (URL Parameters):
|
||||
```js
|
||||
@@ -190,7 +190,7 @@ __________________________________________________________________
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**GET** `/api/getViewsForUser`
|
||||
##### **GET** `/api/getViewsForUser`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -212,7 +212,7 @@ __________________________________________________________________
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**GET** `/api/getSavedTimeForUser`
|
||||
##### **GET** `/api/getSavedTimeForUser`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -234,7 +234,7 @@ __________________________________________________________________
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**POST** `/api/setUsername`
|
||||
##### **POST** `/api/setUsername`
|
||||
|
||||
**Input** (URL Parameters):
|
||||
```js
|
||||
@@ -259,7 +259,7 @@ __________________________________________________________________
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**GET** `/api/getUsername`
|
||||
##### **GET** `/api/getUsername`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -283,7 +283,7 @@ __________________________________________________________________
|
||||
|
||||
### Stats Calls
|
||||
|
||||
**GET** `/api/getTopUsers`
|
||||
##### **GET** `/api/getTopUsers`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -308,7 +308,7 @@ __________________________________________________________________
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**GET** `/api/getTotalStats`
|
||||
##### **GET** `/api/getTotalStats`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -334,7 +334,7 @@ __________________________________________________________________
|
||||
None
|
||||
__________________________________________________________________
|
||||
|
||||
**GET** `/api/getDaysSavedFormatted`
|
||||
##### **GET** `/api/getDaysSavedFormatted`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -359,7 +359,7 @@ __________________________________________________________________
|
||||
|
||||
These can only be called by the users added to the VIP table.
|
||||
|
||||
**GET** `/api/isUserVIP`
|
||||
##### **GET** `/api/isUserVIP`
|
||||
|
||||
**Input**:
|
||||
```js
|
||||
@@ -382,7 +382,7 @@ These can only be called by the users added to the VIP table.
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**POST** `/api/noSegments`
|
||||
##### **POST** `/api/noSegments`
|
||||
|
||||
Will block new segment submissions of the specified category on that video.
|
||||
|
||||
@@ -410,7 +410,7 @@ Will block new segment submissions of the specified category on that video.
|
||||
|
||||
__________________________________________________________________
|
||||
|
||||
**POST** `/api/shadowBanUser`
|
||||
##### **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.
|
||||
|
||||
@@ -438,7 +438,7 @@ Shadow banned submissions are hidden for everyone but the IP that originally sub
|
||||
403: Unauthorized (You are not a VIP)
|
||||
__________________________________________________________________
|
||||
|
||||
**POST** `/api/warnUser`
|
||||
##### **POST** `/api/warnUser`
|
||||
|
||||
Temporary ban that shows a warning asking them to contact us.
|
||||
|
||||
@@ -468,7 +468,7 @@ __________________________________________________________________
|
||||
|
||||
These can only be called by the server administrator, set in the config.
|
||||
|
||||
**POST** `/api/addUserAsVIP`
|
||||
##### **POST** `/api/addUserAsVIP`
|
||||
|
||||
VIPs have extra privileges and their votes count more.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user