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"
}