Fix formatting

This commit is contained in:
MerlinScheurer 2024-05-13 14:56:39 +02:00
parent 256ee8c768
commit 674de5fa69

View File

@ -1,10 +1,8 @@
# Additional API endpoints
## Login
Return token and user ID for username and password:
**POST** `/api/login/`
```json
{
"username": "tubearchivist",
@ -13,7 +11,6 @@ Return token and user ID for username and password:
```
after successful login returns
```json
{
"token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
@ -22,16 +19,14 @@ after successful login returns
```
## Refresh
**GET** `/api/refresh/`
Parameters:
- **type**: one of _video_, _channel_, _playlist_, optional
- **type**: one of *video*, *channel*, *playlist*, optional
- **id**: item id, optional
without specifying type: return total for all queued items:
```json
{
"total_queued": 2,
@ -41,7 +36,6 @@ without specifying type: return total for all queued items:
```
specify type: return total items queue of this type:
```json
{
"total_queued": 2,
@ -50,8 +44,7 @@ specify type: return total items queue of this type:
}
```
specify type _and_ id to get state of item in queue:
specify type *and* id to get state of item in queue:
```json
{
"total_queued": 2,
@ -67,8 +60,7 @@ Parameter:
- extract_videos: to refresh all videos for channels/playlists, default False
Manually start a refresh task: post list of _video_, _channel_, _playlist_ IDs:
Manually start a refresh task: post list of *video*, *channel*, *playlist* IDs:
```json
{
"video": ["video1", "video2", "video3"],
@ -78,10 +70,8 @@ Manually start a refresh task: post list of _video_, _channel_, _playlist_ IDs:
```
## Cookie
Check your youtube cookie settings, _status_ turns to `true` if cookie has been validated.
Check your youtube cookie settings, *status* turns to `true` if cookie has been validated.
**GET** `/api/cookie/`
```json
{
"cookie_enabled": true,
@ -93,7 +83,6 @@ Check your youtube cookie settings, _status_ turns to `true` if cookie has been
**POST** `/api/cookie/`
Send empty post request to validate cookie.
```json
{
"cookie_validated": true
@ -102,24 +91,19 @@ Send empty post request to validate cookie.
**PUT** `/api/cookie/`
Send put request containing the cookie as a string:
```json
{
"cookie": "your-cookie-as-string"
}
```
Imports and validates cookie, returns on success:
```json
{
"cookie_import": "done",
"cookie_validated": true
}
```
Or returns status code 400 on failure:
```json
{
"cookie_import": "fail",
@ -128,13 +112,11 @@ Or returns status code 400 on failure:
```
## Search
**GET** `/api/search/?query=<query>`
Returns search results from your query.
## Watched
**POST** `/api/watched/`
Change watched state, where the `id` can be a single video, or channel/playlist to change all videos belonging to that channel/playlist.
@ -147,12 +129,10 @@ Change watched state, where the `id` can be a single video, or channel/playlist
```
## Ping
Validate your connection and authentication with the API
**GET** `/api/ping/`
When valid returns message with user id and TubeArchivist version:
```json
{
"response": "pong",
@ -162,7 +142,6 @@ When valid returns message with user id and TubeArchivist version:
```
## Notification List
Get all current notifications.
**GET** `/api/notification/`
@ -187,3 +166,4 @@ Parameter:
```
"command" can be false || "STOP" || "KILL".