RESTful API for managing a collection of books. Provides endpoints for CRUD operations on books.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21505573","collectionId":"09dfa768-f9cd-4137-9c47-1f4756d7865c","publishedId":"2sBXcLfcNB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-06T16:36:59.000Z"},"item":[{"name":"Root","item":[{"name":"Get API Info","id":"964509cf-ad0d-4dc2-a70e-66c2e41fad28","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/","description":"Returns general information about the Book API, including version details and a link to the documentation.
\nGET http://localhost:3000/\nNone
\nNot applicable
\nReturns API metadata with version and documentation information.
\n{\n \"name\": \"Book API\",\n \"version\": \"1.0.0\",\n \"description\": \"RESTful API for managing a collection of books\",\n \"documentation\": \"/api/v1/docs\"\n}\n{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred\"\n}\nReturns the current health status of the server, useful for monitoring and load balancer health checks.
\nGET http://localhost:3000/health\nNone
\nNot applicable
\nReturns server health status with a timestamp indicating when the check was performed.
\n{\n \"status\": \"healthy\",\n \"timestamp\": \"2024-01-15T10:30:00.000Z\"\n}\n{\n \"status\": \"unhealthy\",\n \"timestamp\": \"2024-01-15T10:30:00.000Z\",\n \"error\": \"Database connection failed\"\n}\nRoot endpoints for API information and health checks
\n","_postman_id":"fce95dd0-343c-455a-aaba-98a41c5e709a"},{"name":"Books","item":[{"name":"List All Books","id":"7bfedf52-4299-45a6-9293-ee941aa59d62","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/v1/books","description":"Retrieves a list of all books in the collection. Returns an array of book objects.
\nGET http://localhost:3000/api/v1/books\nNone
\nNot applicable
\nReturns an array of all book objects in the collection.
\nReturns an array of book objects:
\n[\n {\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"The Great Gatsby\",\n \"author\": \"F. Scott Fitzgerald\",\n \"year\": 1925\n },\n {\n \"id\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n \"title\": \"To Kill a Mockingbird\",\n \"author\": \"Harper Lee\",\n \"year\": 1960\n },\n {\n \"id\": \"7c9e6679-7425-40de-944b-e07fc1f90ae7\",\n \"title\": \"1984\",\n \"author\": \"George Orwell\"\n }\n]\n\n\nNote: Returns an empty array
\n[]if no books exist in the collection.
{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred\"\n}\nRetrieves a single book by its unique identifier. Use this endpoint to fetch detailed information about a specific book.
\nGET http://localhost:3000/api/v1/books/:id\nNot applicable
\nReturns the book object matching the provided ID.
\n{\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"The Great Gatsby\",\n \"author\": \"F. Scott Fitzgerald\",\n \"year\": 1925\n}\n{\n \"error\": \"Not Found\",\n \"message\": \"Book with id '550e8400-e29b-41d4-a716-446655440000' not found\"\n}\n{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred\"\n}\nThe unique identifier (UUID) of the book to retrieve
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"1291bf35-2c42-435c-842e-a28654c369d4"},{"name":"Create Book","id":"18863df5-51b4-468c-aab0-6b72b65d285d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/api/v1/books","description":"Creates a new book in the collection. The server automatically generates a unique ID for the new book.
\nPOST http://localhost:3000/api/v1/books\nNone
\nSend a JSON object with the book details.
\n{\n \"title\": \"The Great Gatsby\",\n \"author\": \"F. Scott Fitzgerald\",\n \"year\": 1925\n}\nReturns the newly created book object with its generated ID.
\n{\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"The Great Gatsby\",\n \"author\": \"F. Scott Fitzgerald\",\n \"year\": 1925\n}\n{\n \"error\": \"Bad Request\",\n \"message\": \"Validation failed\",\n \"details\": [\n { \"field\": \"title\", \"message\": \"Title is required\" }\n ]\n}\n{\n \"error\": \"Bad Request\",\n \"message\": \"Validation failed\",\n \"details\": [\n { \"field\": \"year\", \"message\": \"Year must be a non-negative integer\" }\n ]\n}\n{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred\"\n}\nUpdates an existing book in the collection. Only the fields provided in the request body will be updated; omitted fields remain unchanged.
\nPUT http://localhost:3000/api/v1/books/:id\nSend a JSON object with the fields to update. All fields are optional, but at least one field should be provided.
\n{\n \"title\": \"The Great Gatsby (Revised Edition)\",\n \"year\": 1926\n}\nReturns the updated book object with all its fields.
\n{\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"The Great Gatsby (Revised Edition)\",\n \"author\": \"F. Scott Fitzgerald\",\n \"year\": 1926\n}\n{\n \"error\": \"Bad Request\",\n \"message\": \"Validation failed\",\n \"details\": [\n { \"field\": \"year\", \"message\": \"Year must be a non-negative integer\" }\n ]\n}\n{\n \"error\": \"Not Found\",\n \"message\": \"Book with id '550e8400-e29b-41d4-a716-446655440000' not found\"\n}\n{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred\"\n}\nThe unique identifier (UUID) of the book to update
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"83c1a8bf-b61a-409b-bc86-34b10e2c7554"},{"name":"Delete Book","id":"587914ee-e9aa-411f-ae80-b65dda75044c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:3000:/api/v1/books/:id#","description":"Permanently deletes a book from the collection. This action cannot be undone.
\nDELETE http://localhost:3000/api/v1/books/:id\nNot applicable
\nReturns a confirmation message upon successful deletion.
\n{\n \"message\": \"Book successfully deleted\",\n \"deleted\": {\n \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"title\": \"The Great Gatsby\",\n \"author\": \"F. Scott Fitzgerald\",\n \"year\": 1925\n }\n}\n{\n \"error\": \"Not Found\",\n \"message\": \"Book with id '550e8400-e29b-41d4-a716-446655440000' not found\"\n}\n{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred\"\n}\nThe unique identifier (UUID) of the book to delete
\n","type":"text/plain"},"type":"any","value":"","key":"id"}]}},"response":[],"_postman_id":"587914ee-e9aa-411f-ae80-b65dda75044c"}],"id":"e91292b3-3491-466d-b74d-9cf194dcb8d1","description":"Endpoints for managing books - create, read, update, and delete operations
\n","_postman_id":"e91292b3-3491-466d-b74d-9cf194dcb8d1"}],"variable":[{"id":"9c05796d-0e23-4062-be2b-ac702168ae18","key":"baseUrl","value":"http://localhost:3000","type":"string"}]}