Track usage with enforcement

This is the recommended endpoint for most use cases. It performs three operations in sequence:

1. Rate Limit Check: Validates against configured rate limits (fast, Redis-based)
2. Quota Check: Validates against configured quotas (database-based)
3. Event Ingestion: Records the event if all checks pass

Response Codes:

• 201 Created: Event tracked successfully, all limits within bounds
• 429 Too Many Requests: Rate limit or quota exceeded (check response body for details)

Rate Limit Headers: The response includes standard rate limit headers:

• X-RateLimit-Limit: Maximum requests allowed
• X-RateLimit-Remaining: Requests remaining in current window
• X-RateLimit-Reset: Unix timestamp when window resets
• Retry-After: Seconds to wait before retrying (on 429 responses)

Quota Headers (on quota exceeded): When a quota is exceeded, the response includes:

• Retry-After: Seconds to wait before retrying
• X-Quota-Reset: Unix timestamp when the quota period resets
• X-Quota-Period: Quota period (hour, day, week, month)
• X-Quota-Metric: Quota metric (total_tokens, total_events, total_cost_cents)

Dimension Matching: Quotas and rate limits are matched based on dimensions extracted from:

• customerId → customer_id
• eventType → event_type
• model → model
• provider → provider
• properties → All string values are included as dimensions

curl -X POST "https://api.limitry.com/v1/track" \  -H "Content-Type: application/json" \  -d '{    "customerId": "cust_123",    "eventType": "model_call",    "model": "gpt-4",    "provider": "openai",    "inputTokens": 150,    "outputTokens": 50,    "totalTokens": 200,    "latencyMs": 1200,    "costCents": 25,    "properties": {      "user_id": "user_456",      "team_id": "team_eng",      "feature": "chat"    },    "idempotencyKey": "req_abc123",    "timestamp": "2024-01-15T10:30:00Z"  }'

{
  "id": "evt_abc123",
  "allowed": true,
  "rateLimits": [
    {
      "id": "rl_xyz789",
      "name": "API Rate Limit",
      "window": "1h",
      "limit": 1000,
      "remaining": 847,
      "reset": 1705312800,
      "exceeded": false
    }
  ],
  "quotas": [
    {
      "id": "qta_def456",
      "name": "Daily Token Limit",
      "metric": "total_tokens",
      "period": "day",
      "limit": 100000,
      "used": 45230,
      "remaining": 54770,
      "exceeded": false
    }
  ]
}

{
  "error": "Invalid request"
}

{
  "error": "Invalid or missing API key"
}

{
  "allowed": false,
  "error": "Rate limit exceeded",
  "rateLimits": [
    {
      "id": "rl_xyz789",
      "name": "API Rate Limit",
      "window": "1h",
      "limit": 1000,
      "remaining": 0,
      "reset": 1705312800,
      "exceeded": true
    }
  ],
  "quotas": []
}