REST API

FastLinkIt provides a comprehensive REST API for programmatic access to all features.

Authentication

The API supports three authentication methods:

1. JWT Bearer Token — obtain via POST /api/auth/login
2. API Key — pass via X-Api-Key header
3. Cookie Auth — for Blazor UI (automatic)

API Keys

Generate API keys at Account → API Keys:

1. Enter a name for the key
2. Optionally set an expiration date
3. Select scopes — which API services the key can access:
   • links — short links
   • qrcodes — QR codes
   • geoip — IP geolocation
   • contacts — contact management
   • contact-groups — contact groups
   • mailing — email campaigns
   • organizer — booking system
   • payments-read — read payment data
   • payment-api — create checkouts
   • webhooks — webhook management
   • support — ticket system
   • ticket-submit — external ticket submission
   • fundraising — campaigns
4. Leave all scopes unchecked for full access
5. Click Generate — the key is shown once, copy it immediately

Keys use the format fli_ followed by 32 random bytes.

API Documentation

Interactive API docs are available at /scalar/v1 (development) with the OpenAPI spec at /openapi/v1.json.

Rate Limits

API usage is subject to your subscription plan's link/QR code limits. The API returns 403 with an upgrade message when plan limits are reached.

Available Endpoints