📌 TODO API 문서

🔐 인증 (Authentication)

모든 요청에는 반드시 아래 헤더를 포함해야 합니다:

X-USER-ID: 사용자 식별자 (예: "dusen0528")
Content-Type: application/json

---

🌍 엔드포인트 (Endpoints)

HTTP Method	Endpoint	설명
POST	/api/calendar/events	새로운 TODO 생성
DELETE	/api/calendar/events/{id}	특정 ID의 TODO 삭제
DELETE	/api/calendar/events/daily/{todoDate}	특정 날짜의 모든 TODO 삭제
GET	/api/calendar/events/?year={year}&month={month}&day={day}	특정 날짜의 TODO 조회
GET	/api/calendar/daily-register-count?date={todoDate}	특정 날짜의 TODO 개수 조회
GET	/api/calendar/events/{id}	특정 ID의 TODO 조회
GET	/api/calendar/events/?year={year}&month={month}	특정 월의 TODO 리스트 조회

---

📌 엔드포인트 상세

✅ 1. 새로운 TODO 생성

• 설명: 새로운 TODO를 생성합니다.
• HTTP Method: POST
• URL: /api/calendar/events

헤더:

Content-Type: application/json
X-USER-ID: 사용자 ID

요청 본문 (Request Body):

{
  "subject": "todo 제목",
  "eventAt": "2025-04-02"
}

응답 코드:

• 201 Created: 성공적으로 생성됨 ✅
• 400 Bad Request: 요청 데이터가 잘못됨 ⚠️
• 403 Forbidden: 하루 최대 TODO 개수 초과 ❌

응답 예시:

{
  "id": 123,
  "subject": "todo 제목",
  "eventAt": "2025-04-02",
  "createdAt": "2025-04-02T12:00:00Z"
}

---

❌ 2. 특정 ID의 TODO 삭제

• 설명: 특정 ID에 해당하는 TODO를 삭제합니다.
• HTTP Method: DELETE
• URL: /api/calendar/events/{id}

헤더:

X-USER-ID: 사용자 ID

응답 코드:

• 204 No Content: 성공적으로 삭제됨 ✅
• 404 Not Found: 해당 ID가 존재하지 않음 ⚠️

응답 예시:

{
  "message": "삭제 완료"
}

---

🗑 3. 특정 날짜의 모든 TODO 삭제

• 설명: 지정된 날짜의 모든 TODO를 삭제합니다.
• HTTP Method: DELETE
• URL: /api/calendar/events/daily/{todoDate}

헤더:

X-USER-ID: 사용자 ID

응답 코드:

• 204 No Content: 성공적으로 삭제됨 ✅
• 404 Not Found: 해당 날짜에 등록된 TODO가 없음 ⚠️

---

📅 4. 특정 날짜의 TODO 조회

• 설명: 지정된 날짜에 등록된 모든 TODO를 조회합니다.
• HTTP Method: GET
• URL: /api/calendar/events/?year={year}&month={month}&day={day}

헤더:

X-USER-ID: 사용자 ID

응답 코드:

• 200 OK: 요청 성공 ✅
• 404 Not Found: 해당 날짜에 등록된 TODO가 없음 ⚠️

응답 예시:

[
  {
    "id": 123,
    "subject": "HTML 공부하기",
    "eventAt": "2025-04-02",
    "createdAt": "2025-04-01T12:00:00Z"
  },
  {
    "id": 124,
    "subject": "JavaScript 복습하기",
    "eventAt": "2025-04-02",
    "createdAt": "2025-04-01T13:00:00Z"
  }
]

---

🔢 5. 특정 날짜의 TODO 개수 조회

• 설명: 지정된 날짜에 등록된 TODO 개수를 반환합니다.
• HTTP Method: GET
• URL: /api/calendar/daily-register-count?date={todoDate}

헤더:

X-USER-ID: 사용자 ID

응답 코드:

• 200 OK: 요청 성공 ✅
• 404 Not Found: 해당 날짜에 등록된 TODO가 없음 ⚠️

응답 예시:

{
  "count": 5
}

---

🔍 6. 특정 ID의 TODO 조회

• 설명: 특정 ID에 해당하는 단일 TODO를 조회합니다.
• HTTP Method: GET
• URL: /api/calendar/events/{id}

헤더:

X-USER-ID: 사용자 ID

응답 코드:

• 200 OK: 요청 성공 ✅
• 404 Not Found: 해당 ID가 존재하지 않음 ⚠️

응답 예시:

{
  "id": 123,
  "subject": "HTML 공부하기",
  "eventAt": "2025-04-02",
  "createdAt": "2025-04-01T12:00:00Z"
}

---

📆 7. 월 단위로 TODO 리스트 조회

• 설명: 지정된 연도와 월에 등록된 모든 TODO를 반환합니다.
• HTTP Method: GET
• URL: /api/calendar/events/?year={year}&month={month}

헤더:

X-USER-ID: 사용자 ID

응답 코드:

• 200 OK: 요청 성공 ✅
• 404 Not Found: 해당 월에 등록된 TODO가 없음 ⚠️

응답 예시:

[
  {
    "id": 123,
    "subject": "HTML 공부하기",
    "eventAt": "2025-04-02",
    "createdAt": "2025-04-01T12:00:00Z"
  },
  {
    "id": 124,
    "subject": "JavaScript 복습하기",
    "eventAt": "2025-04-03",
    "createdAt": "2025-04-01T13:00:00Z"
  }
]

---

🚨 에러 처리 (Error Handling)

HTTP 상태 코드	설명
200 OK	요청이 성공적으로 처리됨
201 Created	리소스가 성공적으로 생성됨
204 No Content	요청 성공, 응답 본문 없음
400 Bad Request	잘못된 요청 데이터 ⚠️
403 Forbidden	하루 최대 할 일 개수 초과 ❌
404 Not Found	리소스를 찾을 수 없음 🚫

---