🎬 API de Películas 🎥

Una API RESTful que te brinda acceso a una colección de películas clásicas y modernas, cada una con título, descripción, año y una imagen de portada.

Perfecta para proyectos de cine, apps de catálogo, colecciones personales o aplicaciones de streaming.

Consulta y gestiona las películas fácilmente utilizando métodos HTTP como GET, POST, PUT y DELETE.

🚀 ¡Explora y prueba todos los endpoints en segundos!
Ver colección en Postman

🔗 URL de la API

https://devsapihub.com/api-movies

Puedes acceder a esta API desde cualquier cliente HTTP como Postman o directamente en el navegador.

Probar API
✅ Obtener todas las películas
GET /api-movies GET

Devuelve un array con todas las películas.

🔍 Obtener una película por ID
GET /api-movies/:id GET

Devuelve los datos de una película según su ID.

GET /api-movies/1
➕ Crear nueva película
POST /api-movies/movie POST

Envía un JSON con los datos de la nueva película:

{
    "title": "El Código del Silencio",
    "description": "Un thriller tecnológico donde un joven hacker descubre una red secreta que controla los datos de
    millones de personas.",
    "year": 2023,
    "imageUrl": "https://devsapihub.com/img-movies/codigo-del-silencio.jpg"
}

Respuesta esperada: objeto recién creado y listado completo con GET /api-movies

✏️ Editar película existente
PUT /api-movies/movie/:id PUT

Envía un JSON con los nuevos datos de la película:

{
    "id": 2,
    "title": "Jumanji 2",
    "description": "In Jumanji: The Next Level, the gang is back but the game has changed.",
    "year": 2019,
    "imageUrl": "https://devsapihub.com/img-movies/2.jpg"
}

Respuesta esperada: objeto actualizado

🗑 Eliminar película
DELETE /api-movies/movie/:id DELETE

Elimina la película con el ID especificado.

DELETE /api-movies/3

Respuesta esperada: listado actualizado con GET /api-movies

📅 Obtener películas por año
GET /api-movies/year/:year GET

Devuelve un array de películas correspondientes al año especificado.

GET /api-movies/year/2023

Respuesta esperada: array de películas lanzadas en ese año o error 404 si no hay coincidencias.

📚 Ejemplos de Consumo

const getMovies = async () => {
    try {
        const res = await fetch("https://devsapihub.com/api-movies");
        const data = await res.json();

        if (!res.ok) {
        throw new Error('Error en la respuesta de la API');
        }

        console.log(data);
    } catch (error) {
        console.error("Error al obtener las películas:", error.message);
    }
};

// Llamar a la función
getMovies();
import requests
response = requests.get("https://devsapihub.com/api-movies")
print(response.json())
import axios from "axios";
const getMovies = async () => {
    try {
        const res = await axios.get("https://devsapihub.com/api-movies");
        console.log(res.data);
    } catch (error) {
        console.error("Error al obtener las películas:", error.message);
    }
};

// Llamar a la función
getMovies();
<?php
    $response = @file_get_contents('https://devsapihub.com/api-movies');
    $data = json_decode($response, true);

    echo '<pre>';
    echo $data ? print_r($data, true) : 'Error al obtener o decodificar los datos.';
    echo '</pre>';
?>