Skip to content

Latest commit

 

History

History
105 lines (67 loc) · 5.55 KB

README.md

File metadata and controls

105 lines (67 loc) · 5.55 KB
Raw

Cloud_Application_APIs

APIs for a Yelp like application, instructions below will give you a better idea of what this code consist of.

test.js is the server filer

The goals of this assignment are to have you practice designing a RESTful API from an application description, to begin implementing endpoints for the API you designed, and to write an OpenAPI specification for the API you implemented. The assignment has a few different parts, which are outlined below.

1. Design a RESTful API for a Yelp-like application

Your first task for this assignment is to design a RESTful API (i.e. API endpoints with corresponding request and response bodies) for a Yelp-like application. This application will specifically be centered around businesses and user reviews of businesses in US cities. The API you design should permit the following functionality:

  • Users who own businesses should be able to add their businesses to the application. When a business owner adds their business they will need to include the following information:

    • Business name
    • Business street address
    • Business city
    • Business state
    • Business ZIP code
    • Business phone number
    • Business category and subcategories. We'll talk more about categories and subcategories just below, but these will need to match a list of pre-defined categories and subcategories set up by the administrators of the application.

    The following information may also optionally be included when a new business is added:

    • Business website
    • Business email

  • Business owners may modify any of the information listed above for an already-existing business they own.

  • Business owners may remove a business from the application.

  • Users may get a list of businesses. The representations of businesses in the returned list should include all of the information described above. In a later assignment, we will implement functionality to allow the user to list only a subset of the businesses based on some filtering criteria, but for now, assume that users will only want to fetch a list of all businesses.

  • Users may fetch detailed information about a business. Detailed business information will include all of the information described above as well as reviews of the business and photos of the business (which we discuss below).

  • Users may write a review of an existing business. A review will include the following information:

    • A "star" rating between 0 and 5 (e.g. 4 stars)
    • An "dollar sign" rating between 1 and 4, indicating how expensive the business is (e.g. 2 dollar signs)
    • An optional written review

    Note that a user may write at most one review of any business.

  • Users may modify or delete any review they've written.

  • Users may upload image files containing photos of an existing business. Each photo may have an associated caption.

  • Users may remove any photo they've uploaded, and they may modify the caption of any photo they've uploaded.

  • Users may list all of the businesses they own.

  • Users may list all of the reviews they've written.

  • Users may list all of the photos they've uploaded.

  • Application administrators may create categories and subcategories that business owners may use when creating their business. Categories and subcategories are things like the following:

    • Restaurant
      • Brewpub
      • Chinese
      • Mexican
      • Pizza
      • ...
    • Shopping
      • Grocery store
      • Flowers
      • Clothing
      • Hardware
      • ...
    • Arts and Entertainment
      • Movie theater
      • Art gallery
      • Museum
      • ...
    • ...

  • Application administrators may delete or modify categories and subcategories they've created.

  • Users may list all categories.

  • Users may list all subcategories associated with a given category.

As you're designing your API think about what responses will need to be paginated. Think also about what links to other API resources might be useful to return in a response from a given API endpoint (i.e. how your API will implement HATEOAS). Some of the API endpoints you implement will need some form of authentication. For now, you may make note of this, but you don't need to worry about it for this assignment.

There is no formal deliverable for this part of the assignment, but it will be useful to go through the exercise of designing your API before implementing it.

2. Implement a server for your API

After you've designed your API, implement a server for it using Node.js and Express. Your server should meet the following requirements:

  • A route should be included to implement each of the API endpoints in your design.

  • Application data for your server should be stored in in-memory data structures (i.e. no databases or anything like that yet).

  • Any API endpoint with a parameterized route should perform basic verification of the specified route parameters.

  • Any API endpoint that takes a request body should perform basic verification of the data provided in the request body.

  • Each API endpoint should respond with an appropriate HTTP status code and, when needed, a response body.

  • API endpoints should have paginated responses where appropriate.

  • Your server should run on the TCP port specified by the PORT environment variable.

  • You should be able to launch your server using the command npm start.

There is no formal testing requirement for this assignment, but be prepared to send appropriate queries (using cURL, Postman, etc.) to demonstrate the complete functionality of your API during your grading demo for the assignment.