116 lines
2.6 KiB
Plaintext
116 lines
2.6 KiB
Plaintext
# MovieBox API Documentation
|
|
|
|
Base URL: `http://localhost:5000/api`
|
|
|
|
## Endpoints
|
|
|
|
### 1. Health Check
|
|
Check the status of the API server and upstream connectivity.
|
|
|
|
* **URL:** `/apicheck`
|
|
* **Method:** `GET`
|
|
* **Response:**
|
|
```json
|
|
{
|
|
"status": "Success",
|
|
"code": 200,
|
|
"message": "API is running smoothly",
|
|
"latency": "1376ms",
|
|
"upstream": "OK"
|
|
}
|
|
```
|
|
|
|
### 2. Homepage
|
|
Get the homepage content including top picks, trending, and categories.
|
|
|
|
* **URL:** `/home`
|
|
* **Method:** `GET`
|
|
|
|
### 3. Search
|
|
Search for movies or series.
|
|
|
|
* **URL:** `/search`
|
|
* **Method:** `GET`
|
|
* **Query Params:**
|
|
* `keyword` (required): Search term (e.g., "Batman")
|
|
* `page` (optional): Page number (default: 1)
|
|
* `perPage` (optional): Items per page (default: 24)
|
|
* `subjectType` (optional): Filter by type (default: 0)
|
|
|
|
### 4. Detail
|
|
Get detailed information about a specific movie or series.
|
|
|
|
* **URL:** `/detail`
|
|
* **Method:** `GET`
|
|
* **Query Params:**
|
|
* `subjectId` (required): The ID of the item (e.g., "2918032533596032808")
|
|
|
|
### 5. Sources (Stream & Download)
|
|
Get direct streaming and download links for a specific episode.
|
|
**Note:** The API automatically handles `detailPath` extraction and Referer validation.
|
|
|
|
* **URL:** `/sources`
|
|
* **Method:** `GET`
|
|
* **Query Params:**
|
|
* `subjectId` (required): The ID of the item.
|
|
* `season` (optional): Season number (default: 1).
|
|
* `episode` (optional): Episode number (default: 1).
|
|
* **Response:**
|
|
```json
|
|
{
|
|
"downloads": [...],
|
|
"captions": [...],
|
|
"processedSources": [
|
|
{
|
|
"id": "...",
|
|
"quality": 720,
|
|
"directUrl": "https://...",
|
|
"size": "...",
|
|
"format": "mp4"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### 6. Streaming Links (Raw)
|
|
Get raw streaming links.
|
|
|
|
* **URL:** `/stream`
|
|
* **Method:** `GET`
|
|
* **Query Params:**
|
|
* `subjectId` (required)
|
|
* `detailPath` (required)
|
|
* `season` (optional)
|
|
* `episode` (optional)
|
|
|
|
### 7. Download Links (Raw)
|
|
Get raw download links.
|
|
|
|
* **URL:** `/download`
|
|
* **Method:** `GET`
|
|
* **Query Params:**
|
|
* `subjectId` (required)
|
|
* `detailPath` (required)
|
|
* `season` (optional)
|
|
* `episode` (optional)
|
|
|
|
### 8. Trending
|
|
Get trending content.
|
|
|
|
* **URL:** `/trending`
|
|
* **Method:** `GET`
|
|
|
|
### 9. Rank
|
|
Get search rankings/hot moves.
|
|
|
|
* **URL:** `/rank`
|
|
* **Method:** `GET`
|
|
|
|
### 10. Recommend
|
|
Get recommendations based on a subject.
|
|
|
|
* **URL:** `/recommend`
|
|
* **Method:** `GET`
|
|
* **Query Params:**
|
|
* `subjectId` (required)
|