Trailers

The Trailers API allows you to manage movie and TV series trailers.

List Trailers

GET /api/v1/trailers

Query Parameters

Parameter Type Required Description
trailer_id integer No Filter by trailer ID
title string No Filter by title

Response

{
    "data": [
        {
            "trailer_id": 1,
            "title": "Breaking Bad Season 1 Trailer",
            "url": "https://youtube.com/watch?v=...",
            "trailerable_type": "App\\Models\\TvSeries",
            "trailerable_id": 1
        }
    ],
    "links": {
        "first": "https://api.dobridobrev.com/api/v1/trailers?page=1",
        "last": "https://api.dobridobrev.com/api/v1/trailers?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 50,
        "to": 1,
        "total": 1
    }
}

Get Trailer

GET /api/v1/trailers/{trailer_id}

Path Parameters

Parameter Type Required Description
trailer_id integer Yes Trailer ID

Response

{
    "data": {
        "trailer_id": 1,
        "title": "Breaking Bad Season 1 Trailer",
        "url": "https://youtube.com/watch?v=...",
        "trailerable_type": "App\\Models\\TvSeries",
        "trailerable_id": 1
    }
}

Create Trailer

POST /api/v1/trailers

Request Body

Parameter Type Required Description
title string Yes Trailer title
url string Yes YouTube URL of the trailer
trailerable_type string Yes Related model type (Movie, TvSeries)
trailerable_id integer Yes ID of the related model

Response

{
    "message": "Trailer created successfully",
    "data": {
        "trailer_id": 1,
        "title": "Breaking Bad Season 1 Trailer",
        "url": "https://youtube.com/watch?v=...",
        "trailerable_type": "App\\Models\\TvSeries",
        "trailerable_id": 1
    }
}

Update Trailer

PUT /api/v1/trailers/{trailer_id}

Path Parameters

Parameter Type Required Description
trailer_id integer Yes Trailer ID

Request Body

Same as Create Trailer endpoint.

Response

Same as Create Trailer response.

Delete Trailer

DELETE /api/v1/trailers/{trailer_id}

Path Parameters

Parameter Type Required Description
trailer_id integer Yes Trailer ID

Response

{
    "message": "Trailer deleted successfully"
}