Seasons

The Seasons API allows you to manage TV series seasons.

List Seasons

GET /api/v1/tv-series/{series}/seasons

Path Parameters

Parameter Type Required Description
series integer Yes TV Series ID

Response

{
    "data": [
        {
            "id": 1,
            "number": 1,
            "title": "Season 1",
            "episodes_count": 10,
            "release_date": "2023-01-01",
            "poster_url": "https://api.dobridobrev.com/storage/seasons/1/poster.jpg"
        }
    ]
}

Get Season

GET /api/v1/seasons/{season}

Path Parameters

Parameter Type Required Description
season integer Yes Season ID

Response

{
    "data": {
        "id": 1,
        "number": 1,
        "title": "Season 1",
        "description": "First season of the series...",
        "episodes_count": 10,
        "release_date": "2023-01-01",
        "poster_url": "https://api.dobridobrev.com/storage/seasons/1/poster.jpg",
        "episodes": [
            {
                "id": 1,
                "number": 1,
                "title": "Pilot",
                "duration": 45,
                "thumbnail_url": "https://api.dobridobrev.com/storage/episodes/1/thumbnail.jpg"
            }
        ]
    }
}

Create Season

POST /api/v1/tv-series/{series}/seasons

Path Parameters

Parameter Type Required Description
series integer Yes TV Series ID

Request Body

Field Type Required Description
number integer Yes Season number
title string Yes Season title
description string Yes Season description
release_date date Yes Release date (YYYY-MM-DD)

Response

{
    "data": {
        "id": 1,
        "number": 1,
        "title": "Season 1",
        "description": "First season of the series...",
        "episodes_count": 0,
        "release_date": "2023-01-01"
    }
}

Update Season

PUT /api/v1/seasons/{season}

Path Parameters

Parameter Type Required Description
season integer Yes Season ID

Request Body

Field Type Required Description
title string No Season title
description string No Season description
release_date date No Release date (YYYY-MM-DD)

Response

{
    "data": {
        "id": 1,
        "number": 1,
        "title": "Season 1",
        "description": "First season of the series...",
        "episodes_count": 0,
        "release_date": "2023-01-01"
    }
}

Delete Season

DELETE /api/v1/seasons/{season}

Path Parameters

Parameter Type Required Description
season integer Yes Season ID

Response

{
    "message": "Season deleted successfully"
}