API Reference

Complete REST API documentation for authentication and call management

Authentication

The Kalem.me API uses Bearer token authentication. All API requests must include your API token in the Authorization header.

Base URL

https://kalem.me/api/v1

How to Generate Your API Token

🔑 Step-by-Step Guide

  1. Log in to your Kalem.me Dashboard
  2. Navigate to Settings → API Keys from the sidebar
  3. Click "Generate New API Key" button
  4. Give your API key a descriptive name (e.g., "Production API", "Development Key")
  5. Select appropriate permissions (usually "Full Access" for most integrations)
  6. Click "Create Key" and copy the generated token immediately
  7. Store the token securely - you won't be able to see it again!

💡 Pro Tip: Create separate API keys for different environments (development, staging, production) for better security management.

Security Notice

Never expose your API token in client-side code or public repositories. Always use environment variables or secure configuration management.

Authentication Example

curl -X GET "https://kalem.me/api/v1/call" \
  -H "Authorization: Bearer your_api_token" \
  -H "Accept: application/json"

Rate Limits

API requests are rate limited to ensure fair usage:

  • • Standard Plan: 1,000 requests per hour
  • • Pro Plan: 5,000 requests per hour
  • • Enterprise: Custom limits available

Error Responses

Authentication errors return appropriate HTTP status codes:

401 Unauthorized

Missing or invalid API token

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API token"
  }
}

403 Forbidden

Valid token but insufficient permissions

{
  "error": {
    "code": "forbidden",
    "message": "Insufficient permissions for this resource"
  }
}

429 Too Many Requests

Rate limit exceeded

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds."
  }
}