Simple Unkey API

A simple TypeScript API that returns random data with Unkey authentication.

Features

• 🔐 Unkey API key authentication
• 📊 Random data generation (users, products, quotes, jokes)
• ⚡ Fast and lightweight
• 🛠️ TypeScript with strict type checking
• 📝 Code style enforced with Biome

Setup

1. Install dependencies

pnpm install

2. Configure environment variables

Copy .env.example to .env and add your Unkey credentials:

cp .env.example .env

Update the .env file with your actual Unkey credentials:

• MY_ROOT_KEY: Your Unkey root key (get it from https://unkey.com)

3. Run the development server

pnpm dev

The server will start on http://localhost:8080 (or the PORT specified in .env).

Docker

Build the Docker image

docker build -t simple-unkey-api .

Run the container

docker run -p 8080:8080 \
  -e MY_ROOT_KEY=your_unkey_root_key_here \
  simple-unkey-api

Or using a .env file:

docker run -p 8080:8080 --env-file .env simple-unkey-api

API Endpoints

Public Endpoints

• GET / - API information and available endpoints
• GET /health - Health check endpoint

Protected Endpoints (require Unkey API key)

All endpoints under /api/* require a valid Unkey API key in the Authorization header.

• GET /api/users?count=5 - Get random users
• GET /api/products?count=5 - Get random products
• GET /api/quotes?count=1 - Get random quotes
• GET /api/jokes?count=1 - Get random jokes
• GET /api/random - Get a random item of any type

Authentication

Include your Unkey API key in the Authorization header:

curl -H "Authorization: Bearer your_api_key_here" http://localhost:8080/api/users

Examples

Get 10 random users

curl -H "Authorization: Bearer your_api_key_here" http://localhost:8080/api/users?count=10

Get 5 random products

curl -H "Authorization: Bearer your_api_key_here" http://localhost:8080/api/products?count=5

Get a random quote

curl -H "Authorization: Bearer your_api_key_here" http://localhost:8080/api/quotes

Get random jokes

curl -H "Authorization: Bearer your_api_key_here" http://localhost:8080/api/jokes?count=3

Development

Build for production

pnpm build

Start production server

pnpm start

Lint code

pnpm lint

Auto-fix linting issues

pnpm lint:fix

Tech Stack

• TypeScript
• Express.js
• Unkey for authentication
• Biome for linting and formatting
• pnpm for package management