🔐 URL Verifier API

Secure URL generation with ban verification and fingerprinting

✨ Features

🔗 Generate secure, time-limited URLs
🚫 Multi-layer ban system (IP, User ID, Device Fingerprint)
🎯 FingerprintJS device identification
📊 Metrics and analytics
🔑 API key authentication

🚀 API Endpoints

POST /generate

Generate a secure, short-lived URL

Headers: X-API-Key: your-api-key
Content-Type: application/json

Body:
{
  "userId": "user123",
  "destinationUrl": "https://example.com/protected",
  "expiresIn": 300,
  "oneTimeUse": false
}

POST /api/ban

Ban an IP, user, or visitor fingerprint

Headers: X-API-Key: your-admin-key
Content-Type: application/json

Body:
{
  "type": "ip|user|visitor",
  "value": "192.168.1.1",
  "reason": "Suspicious activity"
}

GET /api/bans

List all bans (optionally filter by type)

Headers: X-API-Key: your-admin-key

Query params: ?type=ip|user|visitor (optional)

POST /api/unban

Remove a ban

Headers: X-API-Key: your-admin-key
Content-Type: application/json

Body:
{
  "type": "ip|user|visitor",
  "value": "192.168.1.1"
}

GET /api/metrics

View access metrics and recent events

Headers: X-API-Key: your-admin-key

Query params: ?type=generated|success|blocked (optional)

GET /api/link-status

Check status of a specific link

Headers: X-API-Key: your-admin-key

Query params: ?token=YOUR_TOKEN

📖 Documentation

For detailed documentation, visit the GitHub repository or check the deployment guide.

🔒 Security

All endpoints require authentication via X-API-Key header. User endpoints require API_KEY, admin endpoints require ADMIN_API_KEY.