Generate a New Access Key to Securely Request Your TakeShape Content with an API Endpoint
In this lesson, you'll learn how to use your TakeShape.io account to create a new API Key that will allow you to make authenticated requests to the TakeShape API. We'll walk through finding where to create a new key in the TakeShape project dashboard and using the UI to create and store a new key.
Colby Fayock: [0:00] We're going to start off with a new project in TakeShape. In order to use our content, we need to use the TakeShape API. In order to use the TakeShape API, we need an API Key. In our account, we're going to open up this dropdown where we're going to select API Keys.
[0:13] If this is your first time here, you'll have no API Keys and it'll look similar to this. To create a new key, let's go to New API Key. Here, we can give it a title. I'm going to call it Website. Under Permissions, since we only need to fetch the data, we're just going to use Read. Once you're ready, you can click Create API Key. Once your key is created, you're going to get this little popup that gives you your key.
[0:33] There's two important things to keep in mind with this key. The first is this is the only time you're ever going to see this key, so you want to make sure you copy it down to somewhere safe.
[0:41] Additionally, with this key, you can fetch all of your data from the CMS. You want to make sure this key is kept safe and secure. That also means never checking it into your git provider like GitHub. Once you copied your key safely and secure, you can click I understand and dismiss the page. With that key, we're ready to get our data.
[0:58] In review, we went to the API Keys section of our TakeShape project. Once there, we created a new API key where we gave it a title, and we gave it a permission of Read. Once we hit Create and copy it securely, we have our new key.