Module 3 Practice Assessment

Good to knows about this practice assessment:

• Integrate 3rd Party APIs
• Write tests for the added features
• Expose API endpoints

Optional

• Create JSON responses that follow JSON:API Specs
• Use jsonapi_serializer gem to format responses

Preparation

We’ll be working off of Destination Planner 7

git clone git@github.com:turingschool-examples/destination-planner-7.git
cd destination-planner-7
bundle install
bundle exec rails db:{create,migrate,seed}
bundle exec rails server

Practice Challenges

NOTE: The actual final assessment will equal stories 1 & 2 of this practice assessment. Stories 3 & 4 would be extensions, or another set of practice you could do optionally.

1. Current Weather

For this story, we will be using the OpenWeatherMap API. Sign up for an api key and familiarize yourself with the documentation. Please note that it may take a while for your api key to be activated.

As a user
When I visit "/"
And I click on a destination
Then I should be on page "/destinations/:id"
Then I should see the destination's name, zipcode, description, and current weather
The weather forecast is specific to the destination whose page I'm on
The forecast should include date (weekday, month and day), current, high and low temps in Fahrenheit, and a summary (for example "light rain", "clear sky", etc.)

2. Weather Image

For this story, we will using the Giphy API.

As a user
When I visit "/"
And I click on a destination
Then I should be on page "/destinations/:id"
Then I should see an image related to the current weather at the destination

Note: you have some flexibility here to determine what a “related” image might be.

REMINDER: Stories 3 and 4 below would be considered extensions, or extra practice for you to hone your API consumption/Rails skills.

3. Create an External API for the Destination resource

• RESTful routes should be created to index, show, create, update, and destroy destinations.
• Routes should render JSON or an HTTP status code depending on their purpose.
• These routes should be namespaced under /api/v1/.
• Request specs should be driving the creation of these routes.
• Make sure create, update, and destroy work through Postman

4. Create External API endpoints for Destination Weather

• Expose the information from challenges 1 and 2 in an api endpoint, including destination weather and a related image
• Routes should render JSON or an HTTP status code depending on their purpose.
• You have some freedom to determine what the JSON response looks like.
• These routes should be namespaced under /api/v1/.
• Request specs should be driving the creation of these routes.