Feedback Management APIs

​

Overview

​

Base URL

https://talentg.vercel.app/api

​

Authentication

Authorization: Bearer <supabase_jwt_token>
Content-Type: application/json

​

Feedback Collection

​

Submit Feedback

​

Get User Feedback

​

Admin Feedback Management

​

List All Feedback

​

Respond to Feedback

​

Update Feedback Status

​

Feedback Analytics

​

Feedback Summary

​

Feedback Categories

​

Priority Levels

• Urgent: Critical bugs, security issues, complete service outages
• High: Major functionality issues, payment problems
• Medium: UI/UX issues, feature requests, minor bugs
• Low: General feedback, suggestions, minor improvements

​

Response Templates

​

Common Response Templates

Thank you for reporting this issue. Our technical team has been notified and we're investigating. We'll provide an update within 24 hours.

Thank you for your feature suggestion! We've added this to our roadmap and will consider it for upcoming releases. We'll keep you updated on our progress.

Thank you for your positive feedback! We're thrilled to hear about your good experience and will continue working to maintain this level of quality.

​

Error Handling

​

Common Error Codes

​

Error Response Format

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid feedback category",
    "details": {
      "category": "invalid_category",
      "valid_categories": ["assessment", "support", "platform", "feature_request", "bug_report"]
    }
  }
}

​

Rate Limiting

• Submit feedback: 10 requests per hour per user
• View own feedback: 100 requests per hour per user
• Admin operations: 500 requests per hour per user
• Analytics requests: 200 requests per hour per user

​

SDK Examples

const submitFeedback = async (feedbackData) => {
  const token = await getSupabaseToken();

  const response = await fetch('/api/feedback', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(feedbackData)
  });

  return response.json();
};

// Usage
const result = await submitFeedback({
  category: 'assessment',
  rating: 5,
  title: 'Great assessment!',
  comment: 'The results were very accurate and helpful.',
  metadata: {
    assessment_type: 'strength_finder'
  }
});

​

Best Practices

​

For Users

• Provide specific, actionable feedback
• Include relevant context (browser, device, steps to reproduce)
• Rate honestly and provide detailed comments
• Use appropriate categories for faster resolution

​

For Admins

• Respond promptly according to SLA guidelines
• Categorize and prioritize feedback appropriately
• Track action items and follow up on commitments
• Use feedback insights to drive product improvements

​

Data Collection

• Respect user privacy preferences
• Anonymize sensitive information in analytics
• Implement proper data retention policies
• Regularly review and act on feedback trends