106 lines
5.2 KiB
Markdown
106 lines
5.2 KiB
Markdown
# API Endpoints
|
|
|
|
## Video Download & Search
|
|
|
|
- `GET /api/search` - Search for videos online (YouTube)
|
|
- Query params: `query` (required), `limit` (optional, default: 8), `offset` (optional, default: 1)
|
|
- `POST /api/download` - Download a video from supported platforms
|
|
- Body: `{ url: string, ...options }`
|
|
- Supports: YouTube, Bilibili, MissAV, and all yt-dlp supported sites
|
|
- `GET /api/check-video-download` - Check if a video has already been downloaded
|
|
- Query params: `url` (required)
|
|
- Returns: `{ found: boolean, status: 'exists' | 'deleted', videoId?: string, ... }`
|
|
- `GET /api/check-bilibili-parts` - Check if a Bilibili video has multiple parts
|
|
- Query params: `url` (required)
|
|
- `GET /api/check-bilibili-collection` - Check if a Bilibili URL is a collection/series
|
|
- Query params: `url` (required)
|
|
- `GET /api/download-status` - Get status of active downloads
|
|
- Returns: `{ active: [], queued: [] }`
|
|
|
|
## Video Management
|
|
|
|
- `POST /api/upload` - Upload a local video file
|
|
- Multipart form data: `video` (file)
|
|
- Automatically generates thumbnail
|
|
- `GET /api/videos` - Get all downloaded videos
|
|
- Query params: `page` (optional), `limit` (optional), `sortBy` (optional), `order` (optional), `search` (optional), `author` (optional), `tags` (optional)
|
|
- `GET /api/videos/:id` - Get a specific video by ID
|
|
- `PUT /api/videos/:id` - Update video details
|
|
- Body: `{ title?, author?, tags?, rating?, ... }`
|
|
- `DELETE /api/videos/:id` - Delete a video and its files
|
|
- `GET /api/videos/:id/comments` - Get video comments (if available)
|
|
- `POST /api/videos/:id/rate` - Rate a video (1-5 stars)
|
|
- Body: `{ rating: number }`
|
|
- `POST /api/videos/:id/refresh-thumbnail` - Refresh video thumbnail
|
|
- `POST /api/videos/:id/view` - Increment view count
|
|
- `PUT /api/videos/:id/progress` - Update playback progress
|
|
- Body: `{ progress: number }` (seconds)
|
|
- `GET /api/videos/author-channel-url` - Get author channel URL for a video
|
|
- Query params: `sourceUrl` (required)
|
|
- Returns: `{ success: boolean, channelUrl: string | null }`
|
|
- Checks database first, then fetches from YouTube/Bilibili API if not found
|
|
|
|
## Download Management
|
|
|
|
- `POST /api/downloads/cancel/:id` - Cancel an active download
|
|
- `DELETE /api/downloads/queue/:id` - Remove a download from queue
|
|
- `DELETE /api/downloads/queue` - Clear entire download queue
|
|
- `GET /api/downloads/history` - Get download history
|
|
- Query params: `page` (optional), `limit` (optional)
|
|
- `DELETE /api/downloads/history/:id` - Remove an item from download history
|
|
- `DELETE /api/downloads/history` - Clear entire download history
|
|
|
|
## Collections
|
|
|
|
- `GET /api/collections` - Get all collections
|
|
- `POST /api/collections` - Create a new collection
|
|
- Body: `{ name: string, videoIds?: string[] }`
|
|
- `PUT /api/collections/:id` - Update a collection (add/remove videos)
|
|
- Body: `{ name?: string, videoIds?: string[], action?: 'add' | 'remove' }`
|
|
- `DELETE /api/collections/:id` - Delete a collection
|
|
|
|
## Subscriptions
|
|
|
|
- `GET /api/subscriptions` - Get all subscriptions
|
|
- `POST /api/subscriptions` - Create a new subscription
|
|
- Body: `{ authorUrl: string, interval: number, platform?: string }`
|
|
- `interval`: Check interval in minutes
|
|
- `platform`: 'YouTube' (default) or 'Bilibili'
|
|
- `DELETE /api/subscriptions/:id` - Delete a subscription
|
|
|
|
## Settings & System
|
|
|
|
- `GET /api/settings` - Get application settings
|
|
- `POST /api/settings` - Update application settings
|
|
- Body: `{ [key: string]: any }` - Settings object
|
|
- Supports: `visitorMode`, `cloudDriveEnabled`, `openListApiUrl`, `openListToken`, `openListPublicUrl`, `cloudDrivePath`, and other settings
|
|
- `GET /api/settings/password-enabled` - Check if password protection is enabled
|
|
- `POST /api/settings/verify-password` - Verify login password
|
|
- Body: `{ password: string }`
|
|
- `POST /api/settings/reset-password` - Reset login password
|
|
- Body: `{ oldPassword: string, newPassword: string }`
|
|
- `POST /api/settings/migrate` - Migrate data from JSON to SQLite
|
|
- `POST /api/settings/delete-legacy` - Delete legacy JSON data files
|
|
- `POST /api/settings/format-filenames` - Format video filenames according to settings
|
|
- `POST /api/settings/upload-cookies` - Upload cookies.txt for yt-dlp
|
|
- Multipart form data: `file` (cookies.txt)
|
|
- `POST /api/settings/delete-cookies` - Delete cookies.txt
|
|
- `GET /api/settings/check-cookies` - Check if cookies.txt exists
|
|
- `GET /api/settings/export-database` - Export database as backup file
|
|
- `POST /api/settings/import-database` - Import database from backup file
|
|
- Multipart form data: `file` (database backup file)
|
|
- `GET /api/settings/last-backup-info` - Get information about the last database backup
|
|
- `POST /api/settings/restore-from-last-backup` - Restore database from the last backup
|
|
- `POST /api/settings/cleanup-backup-databases` - Clean up old backup database files
|
|
|
|
## File Management
|
|
|
|
- `POST /api/scan-files` - Scan for existing video files in uploads directory
|
|
- `POST /api/cleanup-temp-files` - Cleanup temporary download files
|
|
|
|
## Cloud Storage
|
|
|
|
- `GET /cloud/videos/:filename` - Proxy endpoint to stream videos from cloud storage (OpenList/Alist)
|
|
- `GET /cloud/images/:filename` - Proxy endpoint to serve images from cloud storage (OpenList/Alist)
|
|
- Note: These endpoints require cloud storage to be configured in settings
|