Interview Endpoints

curl -X POST https://api.yourapp.com/api/mock_interview/questions \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "job_description": "Senior Python Developer with ML experience",
    "question_count": 8,
    "variation_seed": "focus_on_scalability"
  }'

{
  "success": true,
  "question_count": 8,
  "questions": [
    {
      "question": "Describe how you would architect a scalable ML pipeline for real-time predictions",
      "type": "technical"
    },
    {
      "question": "Tell me about a time when you optimized a slow Python application",
      "type": "behavioral"
    },
    {
      "question": "Walk me through your experience with distributed systems",
      "type": "project-based"
    }
  ]
}

curl -X POST https://api.yourapp.com/api/mock_interview/evaluate_answer \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "question": {
      "question": "Explain the difference between REST and GraphQL",
      "type": "technical"
    },
    "answer": "REST uses multiple endpoints while GraphQL uses a single endpoint...",
    "job_description": "Backend Engineer role"
  }'

{
  "success": true,
  "evaluation": {
    "score": 85,
    "grade": "A",
    "strengths": "Clear comparison of REST and GraphQL, mentioned key differences like endpoint structure and data fetching",
    "improvements": "Could expand on use cases and performance trade-offs",
    "ideal_answer": "REST uses multiple endpoints for different resources, while GraphQL provides a single endpoint..."
  }
}

curl -X GET https://api.yourapp.com/api/user/history \
  -H "Authorization: Bearer <token>"

{
  "success": true,
  "sessions": [
    {
      "id": 42,
      "session_type": "agentic",
      "score": 78.5,
      "duration": 1245,
      "created_at": "2026-03-03T14:30:00Z",
      "questions": {
        "questions": [{"question": "Explain SOLID principles"}],
        "answers": {"0": "SOLID is an acronym..."}
      },
      "speech_metrics": {
        "wpm": 145,
        "fluency_score": 0.82,
        "speaking_ratio": 0.65
      }
    }
  ]
}

curl -X POST https://api.yourapp.com/api/query \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is a binary search tree?",
    "top_k": 5
  }'

{
  "success": true,
  "answer": "A binary search tree (BST) is a node-based data structure where each node has at most two children...",
  "sources": [
    {"text": "BST definition...", "_score": 0.92},
    {"text": "BST operations...", "_score": 0.87}
  ]
}

curl -X POST https://api.yourapp.com/api/coding/questions \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "question_count": 3,
    "difficulty": "medium"
  }'

{
  "success": true,
  "questions": [
    {
      "id": 1,
      "question": "Write a SQL query to find the top 5 customers by total purchase amount",
      "language": "sql",
      "difficulty": "medium",
      "expected_output": "SELECT customer_id, SUM(amount)..."
    }
  ]
}

curl -X POST https://api.yourapp.com/api/coding/evaluate \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "question": {"question": "Find top 5 customers"},
    "user_code": "SELECT customer_id, SUM(amount) FROM orders GROUP BY customer_id ORDER BY SUM(amount) DESC LIMIT 5",
    "language": "sql"
  }'

{
  "success": true,
  "evaluation": {
    "is_correct": true,
    "score": 95,
    "feedback": "Great solution! Proper use of GROUP BY and ORDER BY. Consider adding column aliases for clarity."
  }
}