The films endpoint exposes the Rakcha film catalogue. Each film record includes its title, description, runtime, and associated category.
List all films
Returns an array of all film objects. No query parameters are required.
Request
No request body or query parameters are needed.
curl --request GET \
--url https://rakcha.example.com/api/films \
--header 'Authorization: Bearer <token>'
Response fields
Returns a JSON array. Each element has the following fields:
Unique numeric identifier for the film.
The title of the film. Titles start with an uppercase letter.
A short description or synopsis of the film.
The runtime of the film in minutes. Valid values are between 30 and 240 minutes.
The genre or category the film belongs to (e.g., Action, Drama, Comedy).
Example response
[
{
"id": 1,
"title": "Inception",
"description": "A thief who steals corporate secrets through dream-sharing technology is given the task of planting an idea.",
"duration": 148,
"category": "Sci-Fi"
},
{
"id": 2,
"title": "The Dark Knight",
"description": "When the Joker emerges as a new threat, Batman must accept one of the greatest tests of his ability to fight injustice.",
"duration": 152,
"category": "Action"
}
]