List TV Series

Response

{
    "data": [
        {
            "tv_series_id": 1,
            "title": "Breaking Bad",
            "year": 2008,
            "imdb_rating": 9.5,
            "total_seasons": 5,
            "status": "published",
            "category": {
                "id": 1,
                "name": "Drama"
            },
            "poster": "https://api.dobridobrev.com/storage/tv-series/1/poster.jpg"
        }
    ],
    "links": {
        "first": "https://api.dobridobrev.com/api/v1/tv-series?page=1",
        "last": "https://api.dobridobrev.com/api/v1/tv-series?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 15,
        "to": 1,
        "total": 1
    }
}

Get TV Series

Path Parameters

Parameter	Type	Required	Description
tv_series	integer	Yes	TV Series ID

Response

{
    "data": {
        "tv_series_id": 1,
        "title": "Breaking Bad",
        "year": 2008,
        "imdb_rating": 9.5,
        "total_seasons": 5,
        "status": "published",
        "category": {
            "id": 1,
            "name": "Drama"
        },
        "poster": "https://api.dobridobrev.com/storage/tv-series/1/poster.jpg",
        "description": "A high school chemistry teacher turned methamphetamine manufacturer...",
        "backdrop": "https://api.dobridobrev.com/storage/tv-series/1/backdrop.jpg",
        "persons": [
            {
                "id": 1,
                "name": "Vince Gilligan",
                "pivot": {
                    "role": "creator"
                }
            }
        ],
        "trailers": [
            {
                "id": 1,
                "url": "https://youtube.com/watch?v=..."
            }
        ],
        "images": [
            {
                "id": 1,
                "type": "poster",
                "url": "https://api.dobridobrev.com/storage/tv-series/1/poster.jpg"
            },
            {
                "id": 2,
                "type": "backdrop",
                "url": "https://api.dobridobrev.com/storage/tv-series/1/backdrop.jpg"
            }
        ],
        "seasons": [
            {
                "season_id": 1,
                "season_number": 1,
                "year": 2008,
                "total_episodes": 7,
                "poster": "https://api.dobridobrev.com/storage/seasons/1/poster.jpg"
            }
        ]
    }
}

Create TV Series

Request Body

Parameter	Type	Required	Description
title	string	Yes	TV Series title (max 255 characters)
description	string	Yes	TV Series description
year	integer	Yes	Release year
imdb_rating	numeric	No	IMDB rating (between 0 and 10)
total_seasons	integer	No	Total number of seasons
status	string	Yes	TV Series status (published, draft, coming soon)
category_id	integer	Yes	Category ID

Response

{
    "data": {
        "tv_series_id": 1,
        "title": "Breaking Bad",
        "year": 2008,
        "imdb_rating": 9.5,
        "total_seasons": 5,
        "status": "published",
        "category": {
            "id": 1,
            "name": "Drama"
        },
        "poster": "https://api.dobridobrev.com/storage/tv-series/1/poster.jpg"
    }
}

Update TV Series

Path Parameters

Parameter	Type	Required	Description
tv_series	integer	Yes	TV Series ID

Request Body

Same as Create TV Series endpoint.

Response

Same as Create TV Series response.

Delete TV Series

Path Parameters

Parameter	Type	Required	Description
tv_series	integer	Yes	TV Series ID

Response

{
    "message": "TV Series deleted successfully"
}