API Introduction

​

Welcome to FeedbackAI API

​

Base URL

https://your-domain.com/api

http://localhost:3000/api

​

Key Features

​

Authentication

​

Getting Started

1. Sign Up: Create an account through the web interface
2. Get Session Token: Authenticate via Clerk to receive a session token
3. Include Token: Include the token in the Authorization header

fetch('/api/users', {
  headers: {
    'Authorization': `Bearer ${sessionToken}`,
    'Content-Type': 'application/json'
  }
})

​

Role-Based Access

​

Rate Limiting

• Free Tier: 1000 requests/hour
• Pro Tier: 10000 requests/hour
• Enterprise: Custom limits

​

Error Handling

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "field": "email",
      "issue": "Must be a valid email address"
    }
  }
}

​

Common Error Codes

• UNAUTHORIZED (401): Invalid or missing authentication
• FORBIDDEN (403): Insufficient permissions
• NOT_FOUND (404): Resource not found
• VALIDATION_ERROR (400): Invalid request data
• RATE_LIMITED (429): Too many requests

​

Response Format

{
  "success": true,
  "data": {
    // Response data here
  },
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 100
  }
}