Introduction
Remember the warm-up in the previous project when you played with an API? Now it’s time to actually use one. Huzzah! For that, we will use another service, called Pexels. You’ll create a basic photo widget that allows you to display photos from your Pexels gallery. We’ll rely on a tutorial for much of the heavy lifting but the principles of what you do here will be repeatable for use with other APIs.
Assignment
- Start by creating an account on Pexels. Click the “Join” button.
- Log in and click on the three dots top-right, select “Image & Video API”. Next, click the “Your API Key” button.
- You’ll have to give them some basic information about your app. Fill the form and let them know how awesome your photo gallery app will be. Click “Generate API Key” to get a key generated for you. Copy it somewhere you can get to it later. You can find it again however, while logged in, by re-visiting “Your API Key”.
- Browse the website for some photos then add them to a collection (or upload your own!). Navigate to your created collection, and notice the URL will look like
https://www.pexels.com/collections/collectionTitle-collectionIDhere/. An example would beadkmjqz. You’ll need that later for some of the API methods. - Create a new Rails app and add a gem for the Pexels API. There are gems for pretty much every API out there. They will all require you to include your API keys and secret keys somehow. Look for gems that are maintained (have recent commits) and well-adopted (GitHub stars is one way to get a good gauge for how valuable a gem is). Alternatively, you can browse through RubyGems to see popular gems.
- One note is that it’s not good practice to have your API key hard coded into your app because then it’s hardly a secret, especially if you’re pushing to GitHub. A better practice is to store the key in an environment variable or use a gem like
figaro(see docs). You can read the Web Crunch article on Rails credentials as well (although not mentioned in the article, the value of each key can also be accessed by chaining keys as methods as shown in the Rails Guides examples). Environment variables allow you to push your key to your app directly from the command line when it fires up. Figaro operates under the same principle, though it helps you out by allowing you to store the keys in an actual file that just doesn’t get committed with the rest of your code. Rails credentials encrypts the keys using the master key. Use one of these techniques unless you’re a cowboy. - Build a basic StaticPagesController to display a home page with a basic form. The form should just be a single text field which takes the ID for a Pexel collection you have created. Once the form is submitted, the page should refresh and display the photos from that collection.
- Read Pexel API docs for more information on how the API works.
Additional resources
This section contains helpful links to related content. It isn’t required, so consider it supplemental.
- It looks like this lesson doesn’t have any additional resources yet. Help us expand this section by contributing to our curriculum.