18 lines (16 loc) · 8.31 KB

API REST del sistema de libros de papel.

Las opciones son:

Crear un libro.
Borrar un libro.
Modificar un libro completamente: con todos los campos.
Modificar un libro parcialmente: parte de los campos.
Búsqueda de un libro por varios campos.
Búsqueda de un libro por su id

Descripción API	Método HTTP	URI	Query Params	Cuerpo de la petición (Ejemplo)	Cuerpo de la respuesta (ejemplo)	Códigos de respuesta
Crear un libro	POST	/books		{"titulo": "Alas de sangre", "autor": "Rebecca Yarros", "fecha_de_publicación": "2023-11-02", "editorial": "Editorial Planeta", "categoría": "Fantasía romántica", "ISBN": "9788408279797", "portada": "https://imagessl0.casadellibro.com/a/l/s7/90/9788408279990.webp", "sinopsis": "Violet entra en la academia de jinetes de dragón, donde la supervivencia es incierta. Entre enemigos y secretos, deberá demostrar su valía para sobrevivir.", "visible": true, "stock": true, "precio": 21.9}	{"id": 1, "titulo": "Alas de sangre", "autor": "Rebecca Yarros", "fecha_de_publicación": "2023-11-02", "editorial": "Editorial Planeta", "categoría": "Fantasía romántica", "ISBN": "9788408279797", "portada": "https://imagessl0.casadellibro.com/a/l/s7/90/9788408279990.webp", "sinopsis": "Violet entra en la academia de jinetes de dragón, donde la supervivencia es incierta. Entre enemigos y secretos, deberá demostrar su valía para sobrevivir.", "visible": true, "stock": true, "precio": 21.9}	201 : Created 400: bad request 409: Conflict. En el caso de duplicado. 500: Internal server error
Borrar un libro	DELETE	/books/{id}			{"message" : "libro borrado"}	200: Ok. 404: Not Found. 500: Internal Server Error.
Modificar libro: con todos los campos	PUT	/books/{id}		{"título": "La mala costumbre", "autor": "Alana S. Portero", "fecha_de_publicación": "2023-03-01", "editorial": "Seix Barral", "categoría": "Narrativa contemporánea", "ISBN": "9788432242281", "portada": "https://imagessl.casadellibro.com/a/l/t0/81/9788432242281.jpg", "sinopsis": "Una niña trans crece en el Madrid de los ochenta, enfrentando la incomprensión y la violencia. Una historia poderosa sobre identidad y resistencia.", "visible": true, "stock": true, "precio": 18.5}	{"id": 1, "título": "La mala costumbre", "autor": "Alana S. Portero", "fecha_de_publicación": "2023-03-01", "editorial": "Seix Barral", "categoría": "Narrativa contemporánea", "ISBN": "9788432242281", "portada": "https://imagessl.casadellibro.com/a/l/t0/81/9788432242281.jpg", "sinopsis": "Una niña trans crece en el Madrid de los ochenta, enfrentando la incomprensión y la violencia. Una historia poderosa sobre identidad y resistencia.", "visible": true, "stock": true, "precio": 18.5}	200: Ok 400: bad request. 404: not found. 500: internal server error.
Modificar libro: solo parte los campos	PATCH	/books/{id}		{ "fecha_de_publicación": "2024-03-01", "editorial": "Editorial Planeta", "precio": 19}	{"id": 1, "fecha_de_publicación": "2024-03-01", "editorial": "Editorial Planeta", "precio": 18.5}	200: Ok 400: bad request. 404: not found. 500: internal server error.
Buscar por atributos de libro Cualquier combinación de atributos Ejemplo buscando por editorial y visible.	GET	/books	titulo (busqueda parcial), autor (parcial), desde fecha de publicacion, hasta fecha de publicacion, editorial (parcialmente), categoria (total), ISBN, visible, stock, precio mínimo y precio máximo		{"books": [{"id": 1, "título": "La mala costumbre", "autor": "Alana S. Portero", "fecha_de_publicación": "2023-03-01", "editorial": "Seix Barral", "categoría": "Narrativa contemporánea", "ISBN": "9788432242281", "portada": "https://imagessl.casadellibro.com/a/l/t0/81/9788432242281.jpg", "sinopsis": "Una niña trans crece en el Madrid de los ochenta, enfrentando la incomprensión y la violencia. Una historia poderosa sobre identidad y resistencia.", "visible": true, "stock": true, "precio": 18.5}, }. { "id": 3, "título": "Blackwater I. La riada", "autor": "Michael McDowell", "fecha_de_publicación": "2024-02-01", "editorial": "Seix Barral", "categoría": "Fantasía / Terror / Saga familiar", "ISBN": "9788419650566", "portada": "https://imagessl.casadellibro.com/a/l/t0/66/9788419650566.jpg", "sinopsis": "Una misteriosa mujer aparece tras una riada en Perdido, Alabama. Su llegada desencadena oscuros acontecimientos que marcarán a la familia Caskey.", "visible": true, "stock": true, "precio": 22.0 }] }	200: Accepted. 400: bad request 404: Not Found. 500: Internal Server Error.
Buscar un libro por ID	GET	/books/{id}			{ "id": 3, "título": "Blackwater I. La riada", "autor": "Michael McDowell", "fecha_de_publicación": "2024-02-01", "editorial": "Seix Barral", "categoría": "Fantasía / Terror / Saga familiar", "ISBN": "9788419650566", "portada": "https://imagessl.casadellibro.com/a/l/t0/66/9788419650566.jpg", "sinopsis": "Una misteriosa mujer aparece tras una riada en Perdido, Alabama. Su llegada desencadena oscuros acontecimientos que marcarán a la familia Caskey.", "visible": true, "stock": true, "precio": 22.0}	200: Accepted. 400: bad request 404: Not Found. 500: Internal Server Error.