mirror of
https://github.com/tubearchivist/tubearchivist-frontend.git
synced 2024-11-04 19:30:13 +00:00
add exmples, auth docs, and list endpoints
This commit is contained in:
parent
50006e423c
commit
b28773b3a0
@ -1,14 +1,60 @@
|
|||||||
# TubeArchivist API endpoints
|
# TubeArchivist API
|
||||||
Documentation of available API endpoints
|
Documentation of available API endpoints.
|
||||||
|
**Note: This will change!**
|
||||||
|
|
||||||
|
## Authentication
|
||||||
|
API token will get automatically created, accessible on the settings page. Token needs to be passed as an authorization header with every request. Additionally session based authentication is enabled too: When you are logged in to your TubeArchivist instance, you'll have access to the api in the browser for testing.
|
||||||
|
|
||||||
|
Curl example:
|
||||||
|
```shell
|
||||||
|
curl -v /api/video/<video-id>/ \
|
||||||
|
-H "Authorization: Token xxxxxxxxxx"
|
||||||
|
```
|
||||||
|
|
||||||
|
Python requests example:
|
||||||
|
```python
|
||||||
|
import requests
|
||||||
|
|
||||||
|
url = "/api/video/<video-id>/"
|
||||||
|
headers = {"Authorization": "Token xxxxxxxxxx"}
|
||||||
|
response = requests.get(url, headers=headers)
|
||||||
|
```
|
||||||
|
|
||||||
## Videos
|
## Videos
|
||||||
/api/video/\<video_id>/
|
/api/video/\<video_id>/
|
||||||
|
|
||||||
## Channels
|
## Channel List View
|
||||||
|
/api/channel/
|
||||||
|
|
||||||
|
### Subscribe to a list of channels
|
||||||
|
POST /api/channel
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": [
|
||||||
|
{"channel_id": "UC9-y-6csu5WGm29I7JiwpnA", "channel_subscribed": true}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Channel Item View
|
||||||
/api/channel/\<channel_id>/
|
/api/channel/\<channel_id>/
|
||||||
|
|
||||||
## Playlists
|
## Playlists
|
||||||
/api/playlist/\<playlist_id>/
|
/api/playlist/\<playlist_id>/
|
||||||
|
|
||||||
## Download Queue
|
## Download Queue List View
|
||||||
|
/api/download/
|
||||||
|
|
||||||
|
### Add list of videos to download queue
|
||||||
|
|
||||||
|
POST /api/download/
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": [
|
||||||
|
{"youtube_id": "NYj3DnI81AQ", "status": "pending"}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Download Queue Item View
|
||||||
/api/download/\<video_id>/
|
/api/download/\<video_id>/
|
||||||
|
Loading…
Reference in New Issue
Block a user