API Authentication

The Euron Systems API uses API keys for authentication. All API requests must include a valid API key in the request headers.

Getting Your API Key

1. Go to Settings → API → API Keys.
2. Click Generate New Key.
3. Give the key a descriptive name (e.g., "Website Integration" or "Mobile App").
4. Set permissions for the key (read-only, read-write, or specific endpoints).
5. Copy and securely store the key.

Important: API keys are shown only once at creation. If you lose a key, you must generate a new one.

Authentication Methods

API Key (Header)

Include your API key in the Authorization header:

curl https://api.euronsystems.com/v1/courses \
  -H "Authorization: Bearer YOUR_API_KEY"

API Key (Query Parameter)

Alternatively, pass the key as a query parameter (not recommended for production):

curl "https://api.euronsystems.com/v1/courses?api_key=YOUR_API_KEY"

Rate Limiting

API requests are rate-limited to prevent abuse:

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1703980800

When the rate limit is exceeded, the API returns a 429 Too Many Requests response.

Error Responses

Error responses include a JSON body:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key provided",
    "status": 401
  }
}

Security Best Practices

1. Never expose API keys in client-side code (JavaScript in the browser).
2. Use environment variables to store keys in server-side applications.
3. Rotate keys regularly — generate new keys and deprecate old ones.
4. Use least-privilege — assign only the permissions each key needs.
5. Monitor usage — review API logs for suspicious activity.

Related Documentation

• Courses API — Course endpoints
• Students API — Student endpoints
• Webhooks — Event notifications