Images

The Images API allows you to manage images for movies, TV series, episodes, and user profiles.

List Images

GET /api/v1/images

Query Parameters

Parameter Type Required Description
image_id integer No Filter by image ID
url string No Filter by URL
title string No Filter by title

Response

{
    "data": [
        {
            "image_id": 1,
            "title": "Breaking Bad Poster",
            "url": "https://api.dobridobrev.com/storage/images/breaking-bad-poster.jpg",
            "type": "poster",
            "imageable_type": "App\\Models\\TvSeries",
            "imageable_id": 1
        }
    ],
    "links": {
        "first": "https://api.dobridobrev.com/api/v1/images?page=1",
        "last": "https://api.dobridobrev.com/api/v1/images?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 50,
        "to": 1,
        "total": 1
    }
}

Get Image

GET /api/v1/images/{image_id}

Path Parameters

Parameter Type Required Description
image_id integer Yes Image ID

Response

{
    "data": {
        "image_id": 1,
        "title": "Breaking Bad Poster",
        "url": "https://api.dobridobrev.com/storage/images/breaking-bad-poster.jpg",
        "type": "poster",
        "imageable_type": "App\\Models\\TvSeries",
        "imageable_id": 1
    }
}

Upload Image

POST /api/v1/images

Request Body

Parameter Type Required Description
title string Yes Image title
file file Yes Image file (jpeg, png, jpg)
type string Yes Image type (poster, backdrop, still)
imageable_type string Yes Related model type (Movie, TvSeries, Episode)
imageable_id integer Yes ID of the related model

Response

{
    "message": "Image created successfully",
    "data": {
        "image_id": 1,
        "title": "Breaking Bad Poster",
        "url": "https://api.dobridobrev.com/storage/images/breaking-bad-poster.jpg",
        "type": "poster",
        "imageable_type": "App\\Models\\TvSeries",
        "imageable_id": 1
    }
}

Update Image

PUT /api/v1/images/{image_id}

Path Parameters

Parameter Type Required Description
image_id integer Yes Image ID

Request Body

Same as Upload Image endpoint.

Response

Same as Upload Image response.

Delete Image

DELETE /api/v1/images/{image_id}

Path Parameters

Parameter Type Required Description
image_id integer Yes Image ID

Response

{
    "message": "Image deleted successfully"
}