[Route]: GET - Random Recipes

[aleish-m]

Feature description

This route should make a call to look up a random recipe using TheMealDB.

• Receives parameter count for the number of recipes requested by User (1 - 7)
• Gets info for the requested number of recipes and sends recipe info to FE as an Array
• Sends FE the following info for each recipe: ID, Name, Picture
• Should be successful with or without a count parameter
  • Valid parameter is a number 1 - 7
  • Default should be 5
• Should be Unsuccessful if invalid count parameter received

Is this a route?

• [x] Yes, this is for a new route
• [ ] Yes, this is for an existing route
• [ ] No, this is for a design/build/architecture feature/change

CRUD Action

{"GET"}

Route Path / Description

v1/random_recipes?count=4

Success - JSON Contract Example

{ Recipes: 
  [
    { ID: "67721"
      Title: "English Breakfast",
      Image_URL: "www.themealdb.com/images/media/meals/qysyss1511558054.jpg"},
    { ID: "73308"
      Title: "Steak and Kidney Pie",
      Image_URL: "www.themealdb.com/images/media/meals/utxryw1511721587.jpg"},
    { ID: "52847"
      Title: "Pork Cassoulet",
      Image_URL: "www.themealdb.com/images/media/meals/wxuvuv1511299147.jpg"}
  ]
}

Success - Return status code

200

Fail - JSON Contract Example(s)

Unacceptable Parameter:
Status: 400 (Bad Request) or 416 (Range Not Satisfiable)
Error Message for Invalid request

API Unavailable:
Status: 503 (Service Unavailable)
Error Message for Service Unavailable

Anything else?

• We want to have this basic implementation running as is, but we will add caching and background workers to this in the next iteration.
• Add any additional Edge cases and Sad Paths that are needed
• Add Documentation as and if needed

Remember: Use GitHub branch creation for naming

[wanderlust-create]

per team meeting default should be 5