RESTful Node.js: A Structured Approach
  • Book Cover
  • About the Author
  • Links and Resources
  • Part I: The Why
    • Foreword
    • Preface
    • Chapter 1: Introduction
      • The Rise of REST and Distributed Systems
      • Problem #1: Structureless Design, Structureless REST
      • The Emergence of JavaScript and Node.js
      • Problem #2: Structureless JavaScript, Structureless Node.js
      • Behold, the Solution: A Structured Approach
      • Summary
  • Part 2: The Theory
    • Chapter 2: REST Origins
      • A Brief History of the Web and the Birth of REST
      • REST vs. HTTP
      • REST - The Abstract Web Architecture
      • HTTP - A Peak at REST's Concrete Implementation
      • What does it mean for an API to be RESTful?
      • Measuring "RESTfulness" with Richardson Maturity Model
      • Pragmatic REST vs Dogmatic REST
      • Summary
    • Chapter 3: RESTful API Design Guidelines and "Best Practices"
      • Theories vs. Principles vs. Guidelines
      • URI Design
      • Method Verbs
      • Status Codes
      • Representational Design
      • Metadata Design
      • Versioning Strategies
      • Security Considerations
      • Documentation
      • Case Study: GitHub
      • Summary
    • Chapter 4: Structured JavaScript Architecture
      • The Monstrous Monolith and Its Downfall
      • Layered/N-Tier Architecture: The Unpopular Proven Way
      • Microservices and Distributed Computing: A Popular Misdirection
      • Summary
    • Chapter 5: The 8 Step Recipe
      • Route Name (URI)
      • Input Request
      • Middleware
      • Validation
      • Domain
      • Events
      • Output Response
      • Test, Refactor, Document
      • Summary
  • Part 3: The Code
    • Chapter 6: Introduction to the Bookstore API
      • The Bookstore API Endpoint Specifications
      • API Design and Code Structure
      • Project Setup
      • Summary
    • Chapter 7: Retrieving Books from our API
      • Retrieving All Books - Planning
      • Retrieving All Books - Implementation
      • Retrieving A Book By ID - Planning
      • Retrieving A Book By ID - Implementation
      • Summary
    • Chapter 8: Adding Authentication to our API
      • Registering the User - Planning
      • Registering the User - Implementation
      • Logging the User In - Planning
      • Logging the User In - Implementation
      • Getting Authenticated User - Planning
      • Getting Authenticated User - Implementation
      • Summary
    • Chapter 9: Adding the Create, Update, and Delete Operations to our API
      • Creating A Book Listing - Planning
      • Creating A Book Listing - Implementation
      • Updating A Book Listing By ID - Planning
      • Updating A Book Listing By ID - Implementation
      • Deleting A Book Listing By ID - Planning
      • Deleting A Book Listing By ID - Implementation
      • Summary
    • Chapter 10: Testing our API
      • Testing the Request
      • Testing the Middleware
      • Testing the Validation
      • Testing the Domain
      • Testing the Event
      • Testing the Response
      • Testing the Controller
      • Integration Test
      • Summary
  • Conclusion
    • Final Words
  • Bonus!
    • Refactoring to HATEOAS
  • Appendix
    • Sources & References
Powered by GitBook
On this page
  • 1 - Route Name
  • 2 - Input Request
  • 3 - Middleware
  • 4 - Validation
  • 5 - Domain
  • 6 - Events
  • 7 - Response(s)
Edit on GitHub
  1. Part 3: The Code
  2. Chapter 7: Retrieving Books from our API

Retrieving A Book By ID - Planning

PreviousRetrieving All Books - ImplementationNextRetrieving A Book By ID - Implementation

Last updated 3 years ago

Refer back to section for the API endpoint specifications.

1 - Route Name

Much like how we planned out the URI for retrieving all books, retrieving a single book is not too far off from that. From the specifications, it seems like this will be a GET request that will fetch a single book by its ID. We can refer back to the sections under chapter 3 for guidelines, specifically the sections and .

The following URI should suffice.

GET /api/v1/books/:id

2 - Input Request

Similar to retrieving all books, there are none.

3 - Middleware

Similar to retrieving all books, there are none.

4 - Validation

Similar to retrieving all books, there are none.

5 - Domain

Similar to the retrieval of all books, we will be using the same 3 entities to orchestrate our domain logic.

  • bookModel

  • bookRepository

  • bookService

We will definitely use the bookRepository and get it a method something like getById().

In the bookService, we would want to have a method as well, perhaps, getBookById(). Also, remember that we want to do some sort of validation to check if the book we are trying to retrieve exists. Recall that we must return a 404 in our response to indicate that a book with the specified ID by the client does not exist.

6 - Events

Similar to retrieving all books, there are none.

7 - Response(s)

There are 2 types of responses that could possibly return from this endpoint.

The first is the book with the specified ID if it does exist in the database.

{
    "status": "success",
    "code": 200,
    "message": "Here is the book with the specified ID."
    "data": {
       "id": "61f88350745d83158f3c746d",
       "title": "Harry Potter and the Goblet of Fire",
       "description": "Mint condition, but will negotiate",
       "price": 99,
       "author": "J.K. Rowling",
       "datePublished": "Sun Oct 10 2021 23:56:34 GMT-0400"
    },
    "errors": null
}

The second is a message indicating to the client that the book with the specified ID does not exist.

{
    "status": "error",
    "code": 404,
    "message": "That book with the specified ID does not exist."
    "data": null,
    "errors": [
        "Book listing not found."
    ]
}
Method Verbs
URI Design
Chapter 6, The Bookstore API Endpoint Specifications, API Endpoint #6: Retrieve a Book Listing