🌀 uuidify

A blazing-fast public UUID/ULID Generator API built with Go — deployed globally via Cloudflare Workers.

Generate unique identifiers instantly — anywhere, anytime. ⚡

---

⚡ Quick Start

curl https://api.uuidify.io
# → {"uuid":"550e8400-e29b-41d4-a716-446655440000"}

---

🔧 Parameters

Param	Type	Default	Description
algorithm	string	uuid	Generator algorithm (uuid or ulid)
version	string	v4	UUID version (v1, v4, or v7)
count	int	1	Number of identifiers to generate (1–1000)
format	string	json	Response format: json or text

Defaults: algorithm=uuid, version=v4, count=1, format=json. ULIDs ignore the version parameter and rely on algorithm=ulid.

---

📦 Response Format

• count = 1 and UUID algorithm ⇒ {"uuid":"550e..."}
• count > 1 and UUID algorithm ⇒ {"uuids":["550e...","6ba7..."]}
• count = 1 and ULID algorithm/version ⇒ {"ulid":"01HX..."}
• count > 1 and ULID algorithm/version ⇒ {"ulids":["01HX...","01HX..."]}

format=text still streams newline-delimited identifiers.

---

🧠 Examples

# Generate a single UUID (v4, default)
curl https://api.uuidify.io
# → {"uuid":"550e8400-e29b-41d4-a716-446655440000"}

# Generate a UUID v1 (algorithm=uuid, version=v1)
curl "https://api.uuidify.io?algorithm=uuid&version=v1"
# → {"uuid":"6ba7b810-9dad-11d1-80b4-00c04fd430c8"}

# Generate multiple UUIDs (v7) in JSON
curl "https://api.uuidify.io?algorithm=uuid&version=v7&count=5"
# → {"uuids":["01234567-89ab-7def-0123-456789abcdef", ...]}

# Generate UUIDs in newline-delimited text
curl "https://api.uuidify.io?format=text&count=3"
# → 550e8400-e29b-41d4-a716-446655440000
# → 6ba7b810-9dad-11d1-80b4-00c04fd430c8
# → 01234567-89ab-7def-0123-456789abcdef

---

# Generate a single ULID (use algorithm=ulid)
curl "https://api.uuidify.io?algorithm=ulid"
# → {"ulid":"01HX7D9PMV4NQVP3J8B1R6R6FZ"}

# Generate multiple ULIDs (count<=1000)
curl "https://api.uuidify.io?algorithm=ulid&count=3"
# → {"ulids":["01HX7D9PMV4NQVP3J8B1R6R6FZ","01HX7D9PMV4NQVP3J8B1R6R6GA","01HX7D9PMV4NQVP3J8B1R6R6HB"]}

# Generate ULIDs in text format
curl "https://api.uuidify.io?algorithm=ulid&format=text&count=2"
# → 01HX7D9PMV4NQVP3J8B1R6R6FZ
# → 01HX7D9PMV4NQVP3J8B1R6R6GA

---

🧩 Local Development

# Run Go backend
make dev
# Visit → http://localhost:8080

# Test UUID generation
curl http://localhost:8080/
# → {"uuid":"550e8400-e29b-41d4-a716-446655440000"}

# Test ULID generation
curl "http://localhost:8080/?version=ulid&count=2"
# → {"ulids":["01K9N48W4SVAN58GRTTVX2FF5J","01K9N48W4SVAN58GRTTX2CZ8N4"]}

# Test worker locally
make worker-dev
# Visit → http://localhost:8787

# Run tests
make test

# Coverage report
make test-coverage

# Run test script
./test.sh

For detailed testing and deployment guidance, see Testing & Deployment.

---

🐳 Docker

docker build -t uuidify:latest .
docker run -p 8080:8080 uuidify:latest

---

⚙️ Makefile Commands

Command	Description
make dev	Run locally with Go
make build	Build the binary
make docker	Build Docker image
make lint	Run static analysis
make test	Run all tests

---

🚀 Deployment

Cloudflare Workers Deploy

# Wrangler login (first time)
wrangler login

# Test worker locally
make worker-dev

# Deploy to production
make worker-deploy

Deployed via Cloudflare Workers with automatic builds from GitHub → main branch.

• Worker: uuidify
• Custom Domain: api.uuidify.io
• Zone: uuidify.io

For detailed deployment info, see Testing & Deployment.

---

🧭 Roadmap

• Deploy via Cloudflare Workers (api.uuidify.io)
• Add public uptime dashboard
• Publish SDKs (Go, Node.js, Python)
• Generate OpenAPI Spec + Postman Collection

---

🧰 Contributing

We welcome PRs! ❤️
Follow Conventional Commits and open an issue first for new features.

---

📝 License

MIT © 2025 İlker Eroğlu