Endpoints Reference

https://acodeplanet.tech/api/v1

http://localhost:3000/api/v1

Authorization: Bearer <your_token>

X-API-Key: <your_api_key>

GET /problems

{
  "success": true,
  "data": {
    "problems": [
      {
        "id": "two-sum",
        "title": "Two Sum",
        "difficulty": "easy",
        "topics": ["arrays", "hash-table"],
        "acceptance_rate": 48.2,
        "status": "solved"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 500,
      "totalPages": 25
    }
  }
}

GET /problems/:slug

{
  "success": true,
  "data": {
    "id": "two-sum",
    "title": "Two Sum",
    "difficulty": "easy",
    "description": "Given an array of integers...",
    "examples": [...],
    "constraints": [...],
    "topics": ["arrays", "hash-table"],
    "companies": ["google", "amazon"],
    "starterCode": {
      "python": "def twoSum(nums, target):\n    pass",
      "javascript": "function twoSum(nums, target) {\n    \n}"
    }
  }
}

POST /problems/:slug/submit
Content-Type: application/json
 
{
  "language": "python",
  "code": "def twoSum(nums, target):\n    seen = {}\n    ..."
}

{
  "success": true,
  "data": {
    "submission_id": "sub_123abc",
    "status": "accepted",
    "runtime": "45 ms",
    "memory": "16.2 MB",
    "testCases": {
      "passed": 57,
      "total": 57
    }
  }
}

GET /submissions

GET /submissions/:id

GET /learning/weak-topics

{
  "success": true,
  "data": {
    "weakTopics": [
      {
        "topic": "dynamic-programming",
        "weakness_score": 78.5,
        "total_attempts": 15,
        "correct_attempts": 4,
        "success_rate": 0.267,
        "recommended_problems": ["dp-001", "dp-002"]
      }
    ],
    "learningProfile": {
      "strongestTopic": "arrays",
      "overallSuccessRate": 0.72,
      "totalProblemsAttempted": 145
    }
  }
}

POST /learning/weak-topics
Content-Type: application/json
 
{
  "topics": ["dynamic-programming", "memoization"],
  "isCorrect": false
}

GET /learning/paths/:pathId/progress

GET /user/me

{
  "success": true,
  "data": {
    "id": "user_123",
    "email": "user@example.com",
    "name": "John Doe",
    "avatar": "https://...",
    "plan": "pro",
    "stats": {
      "problemsSolved": 145,
      "currentStreak": 12,
      "xp": 4500,
      "level": 8
    }
  }
}

PATCH /user/me
Content-Type: application/json
 
{
  "name": "Jane Doe",
  "bio": "Software Engineer"
}

GET /user/stats

POST /payments/create
Content-Type: application/json
 
{
  "planId": "pro"
}

{
  "success": true,
  "data": {
    "orderId": "order_123abc",
    "amount": 79900,
    "currency": "INR",
    "key": "rzp_test_xxx"
  }
}

POST /payments/verify
Content-Type: application/json
 
{
  "razorpay_order_id": "order_123abc",
  "razorpay_payment_id": "pay_123abc",
  "razorpay_signature": "..."
}

GET /payments/status/:orderId

GET /docs

GET /docs?slug=introduction

GET /docs?search=authentication

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired token",
    "details": {}
  }
}