API Series

GET Characters List

https://api.javiercarrasco.es/series/characters

Devuelve un listado con los 10 primeros personajes existentes en la API.

200 OK

[
    {
        "id": 1,
        "name": "Sheldon Cooper",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/SheldonCooper.png",
        "idShow": 1,
        "idActor": 1
    },
    {
        "id": 2,
        "name": "Leonard Hofstadter",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/LeonardHofstadter.png",
        "idShow": 1,
        "idActor": 2
    },
    ...
]

GET Characters List Auth required

https://api.javiercarrasco.es/series/allcharacters

Authorization Bearer Token

Devuelve el listado completo de personajes existentes en la API.

200 OK

[
    {
        "id": 1,
        "name": "Sheldon Cooper",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/SheldonCooper.png",
        "idShow": 1,
        "idActor": 1,
        "favorite": true
    },
    {
        "id": 2,
        "name": "Leonard Hofstadter",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/LeonardHofstadter.png",
        "idShow": 1,
        "idActor": 2,
        "favorite": false
    },
    ...
]

401 Unauthorized or 403 Forbidden

{
    "ok": false,
    "message": "Token inválido"
}

GET Shows List

https://api.javiercarrasco.es/series/shows

Devuelve un listado con las 3 primeras series existentes en la API.

200 OK

[
   {
        "id": 1,
        "title": "The Big Bang Theory",
        "coverImageUrl": "https://api.javiercarrasco.es/series/imgs/TheBigBangTheory.jpg"
    },
    {
        "id": 2,
        "title": "Game of Thrones",
        "coverImageUrl": "https://api.javiercarrasco.es/series/imgs/GameOfThrones.jpg"
    },
  ...
]

GET Shows List Auth required

https://api.javiercarrasco.es/series/allshows

Authorization Bearer Token

Devuelve el listado completo de las series existentes en la API.

200 OK

[
   {
        "id": 1,
        "title": "The Big Bang Theory",
        "coverImageUrl": "https://api.javiercarrasco.es/series/imgs/TheBigBangTheory.jpg",
        "watched": true
    },
    {
        "id": 2,
        "title": "Game of Thrones",
        "coverImageUrl": "https://api.javiercarrasco.es/series/imgs/GameOfThrones.jpg",
        "watched": false
    },
    ...
]

401 Unauthorized or 403 Forbidden

{
    "ok": false,
    "message": "Token inválido"
}

GET Show Details

https://api.javiercarrasco.es/series/showdetails/{id}

Devuelve los detalles de una serie específica.

200 OK

{
    "id": 1,
    "title": "The Big Bang Theory",
    "synopsis": "Comedia sobre un grupo de científicos ...",
    "coverImageUrl": "https://api.javiercarrasco.es/series/imgs/TheBigBangTheory.jpg",
    "characters": [
        {
            "id": 6,
            "name": "Amy Farrah Fowler",
            "imageUrl": "https://api.javiercarrasco.es/series/imgs/AmyFarrahFowler.png"
        },
        {
            "id": 7,
            "name": "Bernadette Rostenkowski-Wolowitz",
            "imageUrl": "https://api.javiercarrasco.es/series/imgs/Bernadette.png"
        },
        ...
    ]
}

GET Actors List

https://api.javiercarrasco.es/series/actors

Devuelve un listado con los 5 primeros actores existentes en la API.

200 OK

[
   {
        "id": 1,
        "name": "Jim",
        "surname": "Parsons",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/JimParsons.png"
    },
    {
        "id": 2,
        "name": "Johnny",
        "surname": "Galecki",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/JohnnyGalecki.png"
    },
    ...
]

GET Actors List Auth required

https://api.javiercarrasco.es/series/allactors

Authorization Bearer Token

Devuelve el listado completo con todos los actores y actrices existentes en la API.

200 OK

[
   {
        "id": 1,
        "name": "Jim",
        "surname": "Parsons",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/JimParsons.png"
    },
    {
        "id": 2,
        "name": "Johnny",
        "surname": "Galecki",
        "imageUrl": "https://api.javiercarrasco.es/series/imgs/JohnnyGalecki.png"
    },
    ...
]

401 Unauthorized or 403 Forbidden

{
    "ok": false,
    "message": "Token inválido"
}

GET Favorite Characters List Auth required

https://api.javiercarrasco.es/series/user/favorites

Authorization Bearer Token

Muestra la lista de personajes favoritos del usuario autenticado.

200 OK

{
    "ok": true,
    "favorites": [
        1,
        12
    ]
}

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

GET Watched Shows List Auth required

https://api.javiercarrasco.es/series/user/watchedshows

Authorization Bearer Token

Muestra la lista de series vistas por el usuario autenticado.

200 OK

{
    "ok": true,
    "watchedShows": [
        2,
        6
    ]
}

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

POST Login

https://api.javiercarrasco.es/series/login

Autentica al usuario mediante su usuario y contraseña, devolviendo un token válido. La petición deberá pasar los datos en el cuerpo.

Body raw (json)

{"usuario": "pedro", "password": "asdfasd"}

200 OK

{
    "ok": true,
    "token": "eyJhbGciOiJIUzI1NiIasdfasdfaVyIiwia...yOasdfasdfgXp6M24mZWV2-afs3va"
}

400 Bad Request

{
    "ok": false,
    "message": "Todos los campos son obligatorios"
}

401 Unauthorized

{
    "ok": false,
    "message": "Credenciales incorrectas"
}

POST Add Favorite Character Auth required

https://api.javiercarrasco.es/series/user/favorites/{id}

Authorization Bearer Token

Añade un personaje a la lista de favoritos del usuario autenticado. La petición pasará el ID del personaje como parámetro de ruta.

201 Created

{
    "ok": true,
    "message": "Personaje añadido a favoritos"
}

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

409 Conflict

{
    "ok": false,
    "message": "El personaje ya está en favoritos"
}

POST Add Watched Show Auth required

https://api.javiercarrasco.es/series/user/watchedshows/{id}

Authorization Bearer Token

Añade una serie a la lista de vistas por el usuario autenticado. La petición pasará el ID de la serie como parámetro de ruta.

201 Created

{
    "ok": true,
    "message": "Serie marcada como vista"
}

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

409 Conflict

{
    "ok": false,
    "message": "La serie ya está marcada como vista"
}

DELETE Delete Favorite Character Auth required

https://api.javiercarrasco.es/series/user/favorites/{id}

Authorization Bearer Token

Elimina un personaje de la lista de favoritos del usuario autenticado. La petición pasará el ID del personaje como parámetro de ruta.

200 OK

{
    "ok": true,
    "message": "Personaje eliminado de favoritos"
}

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

404 Not Found

{
    "ok": false,
    "message": "El personaje no estaba en favoritos"
}

DELETE Delete Watched Show Auth required

https://api.javiercarrasco.es/series/user/watchedshows/{id}

Authorization Bearer Token

Elimina una serie de la lista de vistas del usuario autenticado. La petición pasará el ID de la serie como parámetro de ruta.

200 OK

{
    "ok": true,
    "message": "Serie desmarcada como vista"
}

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

404 Not Found

{
    "ok": false,
    "message": "La serie no estaba marcada como vista"
}

POST Put Comment By Shows Id And User Auth required

https://api.javiercarrasco.es/series/user/comments

Authorization Bearer Token

Permite registrar un comentario de usuario para una serie en la API. Deberá pasarse los datos en el cuerpo de la petición, indicando el identificador de la serie sobre el que se hace el comentario y el texto del comentario.

Body raw (json)

{"idShow": 3, "comment": "Comentario de prueba."}

201 Created

{
    "id": 25,
    "idShow": 3,
    "user": "pepe",
    "comment": "Comentario de prueba."
}

400 Bad Request

{
    "ok": false,
    "message": "Datos inválidos. Verifica que idShow sea un identificador válido y comment no esté vacío."
}

400 Bad Request

{
    "ok": false,
    "message": "No se pudo insertar el comentario en la base de datos. Inténtalo de nuevo más tarde."
}

401 Unauthorized

{
    "ok": false,
    "message": "Usuario del token no existe, por favor, inicia sesión de nuevo."
}

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

GET Comments Show By Id Auth required

https://api.javiercarrasco.es/series/user/comments/{idShow}

Authorization Bearer Token

Obtiene la lista de comentarios de los usuarios según el identificador de la serie indicada.

200 OK

[
    {
        "id": 1,
        "idShow": 1,
        "user": "javier",
        "comment": "Últimamente me estoy aficionando a esta serie."
    },
    {
        "id": 3,
        "idShow": 1,
        "user": "rosa",
        "comment": "Este tipo de series deben verse concentrados."
    },
    {
        "id": 4,
        "idShow": 1,
        "user": "pepe",
        "comment": "No me gusta especialmente."
    },
    ...
]

401 Unauthorized

{
    "ok": false,
    "message": "Token inválido"
}

403 Forbidden

{
    "ok": false,
    "message": "No se proporcionó un token válido"
}

404 Not Found

{
    "ok": false,
    "message": "Comentarios no encontrados"
}