As a developer you have probably used API keys before. Estuary provides a unique identifier used to authenticate a user, developer, or calling program to an application programming interface we have created.
If you don't know what an API key is, this tutorial will be challenging for you, but you can reach out to us if you're stuck. API keys are the standard way to authenticate a project with an API rather than a human user. It is also important you understand how to protect your API key/secrets from bad actors and abuse. If this concept is foreign to you, you might be better off just using https://estuary.tech and storing data through our website.
Before we start, make sure you have done the following:
Create an account on https://estuary.tech. If you have not done this, you won't be able to get an API key for yourself. To create an account you can request access here.
Setup an example application. To use the API in a meaningful way, you should setup a sample application. You can use our next-sass (React + NextJS) GitHub template, our origin (Vue + Vite) template, or anything of your own choosing.
Have experience running code on your machine. You're going to have a really hard time with this tutorial if you've never run code on your computer.
If you're ready, let's begin!
When you sign in to Estuary, you should should land on this page.
Click on API keys.
On this screen you should see a button to generate an API key, click it.
Use your new API key on the screen to the right by replacing the string REPLACE_ME_WITH_API_KEY with your API key.
Now you are ready for the next part, uploading your first file..
curl -X GET -H "Authorization: Bearer REPLACE_ME_WITH_API_KEY" https://api.estuary.tech/viewer