🌀 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 UUIDs to generate (1–1000)
format	string	json	Response format: json or text

---

🧠 Examples

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

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

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

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

---

🧩 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/?count=2&algorithm=ulid"
# → {"uuids":["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 guide, see TESTING.md.

---

🐳 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 guide, see TESTING.md.

---

🧭 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