Unkey Node.js Example

This is an example of how to use the Unkey API with NestJS.

Quickstart

Create a root key

1. Go to /settings/root-keys and click on the "Create New Root Key" button.
2. Enter a name for the key.
3. Select the following workspace permissions: create_key, read_key, encrypt_key and decrypt_key.
4. Click "Create".

Create your API

1. Go to https://app.unkey.com/apis and click on the "Create New API" button.
2. Give it a name.
3. Click "Create".

Create your first API key

1. Click "Create Key" in the top right corner.
2. Feel the form with any key information you want or leave it empty.
3. Click "Create"
4. Copy the key and save it somewhere safe.

Set up the example

1. Clone the repository to your local machine.

1
2git clone <repo-url>
3cd /path/to/repo
4

2. Duplicate the .env.example file and rename it to .env.

1
2cp .env.example .env
3

3. Replace your API key in the .env file.

4. Install the dependencies.

1
2pnpm install
3

5. Run the application.

1
2pnpm run start
3

6. Test the public route as a guest:

1
2curl http://localhost:3000/api/v1/public
3

7. Test the protected route, which requires valid authorization:

1
2curl http://localhost:3000/api/v1/protected -H "Authorization: Bearer <YOUR_API_KEY>"
3

License

This project is licensed under the MIT License - see the LICENSE file for details.