Add Request Feedback

curl -X POST https://api.hitl.sh/v1/api/requests/65f1234567890abcdef12348/feedback \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "feedback": {
      "rating": 5,
      "comment": "Excellent review! Very thorough analysis and quick turnaround time.",
      "accuracy": 5,
      "timeliness": 5,
      "helpfulness": 4,
      "would_recommend": true,
      "tags": ["thorough", "quick", "professional"],
      "category": "positive"
    }
  }'

import requests

def add_request_feedback(request_id, feedback_data):
    """Add comprehensive feedback to a completed request"""
    
    url = f"https://api.hitl.sh/v1/api/requests/{request_id}/feedback"
    headers = {
        "Authorization": "Bearer your_api_key_here",
        "Content-Type": "application/json"
    }
    
    # Validate feedback data
    if "rating" in feedback_data:
        if not (1 <= feedback_data["rating"] <= 5):
            raise ValueError("Rating must be between 1 and 5")
    
    if "comment" in feedback_data:
        if len(feedback_data["comment"]) > 1000:
            raise ValueError("Comment must be 1000 characters or less")
    
    payload = {"feedback": feedback_data}
    
    response = requests.post(url, headers=headers, json=payload)
    
    if response.status_code == 200:
        result = response.json()
        print(f"✅ Feedback submitted successfully")
        print(f"   Feedback ID: {result['data']['feedback_id']}")
        return result
    else:
        error_msg = response.json().get("msg", "Unknown error")
        print(f"❌ Failed to submit feedback: {error_msg}")
        return {"error": True, "msg": error_msg}

# Example usage
feedback = {
    "rating": 5,
    "comment": "Excellent work! Very detailed analysis and spot-on recommendations.",
    "accuracy": 5,
    "timeliness": 4,
    "helpfulness": 5,
    "would_recommend": True,
    "tags": ["thorough", "insightful", "professional"],
    "category": "positive"
}

result = add_request_feedback("65f1234567890abcdef12348", feedback)

const axios = require('axios');

class FeedbackManager {
    constructor(apiKey) {
        this.apiKey = apiKey;
        this.baseURL = 'https://api.hitl.sh/v1';
    }
    
    async addFeedback(requestId, feedbackData) {
        try {
            // Validate feedback data
            this.validateFeedback(feedbackData);
            
            const response = await axios.post(
                `${this.baseURL}/requests/${requestId}/feedback`,
                { feedback: feedbackData },
                {
                    headers: {
                        'Authorization': `Bearer ${this.apiKey}`,
                        'Content-Type': 'application/json'
                    }
                }
            );
            
            console.log('✅ Feedback submitted successfully');
            return response.data;
            
        } catch (error) {
            console.error('❌ Failed to submit feedback:', error.response?.data?.msg);
            throw error;
        }
    }
    
    validateFeedback(feedback) {
        // Validate rating fields
        const ratingFields = ['rating', 'accuracy', 'timeliness', 'helpfulness'];
        ratingFields.forEach(field => {
            if (feedback[field] !== undefined) {
                if (!Number.isInteger(feedback[field]) || feedback[field] < 1 || feedback[field] > 5) {
                    throw new Error(`${field} must be an integer between 1 and 5`);
                }
            }
        });
        
        // Validate comment length
        if (feedback.comment && feedback.comment.length > 1000) {
            throw new Error('Comment must be 1000 characters or less');
        }
        
        // Validate category
        if (feedback.category) {
            const validCategories = ['positive', 'constructive', 'issue'];
            if (!validCategories.includes(feedback.category)) {
                throw new Error('Category must be one of: positive, constructive, issue');
            }
        }
    }
    
    // Helper method for quick positive feedback
    async addPositiveFeedback(requestId, comment, rating = 5) {
        return this.addFeedback(requestId, {
            rating,
            comment,
            category: 'positive',
            would_recommend: true
        });
    }
    
    // Helper method for constructive feedback
    async addConstructiveFeedback(requestId, comment, suggestions) {
        return this.addFeedback(requestId, {
            rating: 3,
            comment,
            category: 'constructive',
            tags: suggestions,
            follow_up_needed: true
        });
    }
}

// Usage
const feedbackManager = new FeedbackManager('your_api_key_here');

// Detailed feedback
await feedbackManager.addFeedback('65f1234567890abcdef12348', {
    rating: 4,
    comment: 'Good analysis but could have been more detailed in the recommendations section.',
    accuracy: 5,
    timeliness: 3,
    helpfulness: 4,
    would_recommend: true,
    tags: ['accurate', 'could-be-more-detailed'],
    category: 'constructive'
});

// Quick positive feedback
await feedbackManager.addPositiveFeedback(
    '65f1234567890abcdef12349', 
    'Perfect response, exactly what we needed!'
);

{
  "error": false,
  "msg": "Feedback added successfully",
  "data": {
    "request_id": "65f1234567890abcdef12348",
    "feedback": {
      "rating": 5,
      "comment": "Excellent review! Very thorough analysis and quick turnaround time.",
      "accuracy": 5,
      "timeliness": 5,
      "helpfulness": 4,
      "would_recommend": true,
      "tags": ["thorough", "quick", "professional"],
      "category": "positive"
    }
  }
}