📦 그라운드 역량 카드 API 가이드

GET /api/v1/classes/{classId}/cards

{
  "success": true,
  "data": {
    "cards": [
      {
        "templateId": "abc123",
        "type": "reward",
        "points": 5,
        "description": "수업 적극 참여",
        "categoryId": "cat_collab",
        "categoryName": "협업"
      }
    ]
  },
  "message": "역량 카드 목록 조회에 성공했습니다."
}

POST /api/v1/classes/{classId}/students/{studentCode}/cards

curl -X POST \
  "https://growndcard.com/api/v1/classes/CLASS_ID/students/2/cards" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_xxx" \
  -d '{ "templateId": "abc123", "source": "QuizApp" }'

{
  "success": true,
  "data": {
    "recordId": "rec_xyz",
    "studentId": "stu_abc",
    "studentCode": 2,
    "type": "reward",
    "pointsAwarded": 5,
    "bonusApplied": 1,
    "totalPoints": 155,
    "currentLevel": 5,
    "leveledUp": false,
    "createdAt": "2026-06-15T01:23:45.000Z",
    "templateId": "abc123",
    "categoryId": "cat_collab"
  },
  "message": "역량 카드가 성공적으로 부여되었습니다."
}