Authentication

All API requests to VIUCraft must be authenticated using an API key.

API Key Header

Include your API key in the X-API-Key header:

curl -H "X-API-Key: your-api-key" \
  https://api.viucraft.com/images

Obtaining an API Key

1. Log in to your VIUCraft dashboard
2. Navigate to Dashboard > API Keys
3. Click Generate New API Key
4. Give your key a descriptive name
5. Copy the key immediately (it will not be shown again)

API Key Best Practices

Use Environment Variables

Never hardcode API keys in your source code:

# .env file
VIUCRAFT_API_KEY=your-api-key

// Node.js
const apiKey = process.env.VIUCRAFT_API_KEY;

Separate Keys for Environments

Create different keys for:

1. Development
2. Staging
3. Production

Key Rotation

Rotate your API keys periodically:

1. Generate a new key
2. Update your applications
3. Revoke the old key

Authentication Errors

Rate Limiting

Rate limits depend on your plan:

| Enterprise | Unlimited | Unlimited |