오늘은 하루 종일 3주차 과제를 계속 진행했다. 과제는 “클라우드 커뮤니티” 라는 서비스를 만들기 위해 REST API를 설계이다. 예를 들면

---

리소스 목록 조회

GET /resources

모든 리소스의 목록을 조회합니다. 이 엔드포인트는 시스템에 등록된 전체 리소스를 페이지네이션 형태로 반환합니다. 대량의 데이터를 효율적으로 처리하기 위해 page와 limit 파라미터를 활용하여 원하는 범위의 데이터만 요청할 수 있습니다.

Request Headers

헤더	타입	필수	설명
Authorization	string	✅	Bearer 토큰 형식의 인증 정보. 로그인 시 발급받은 Access Token을 Bearer {token} 형태로 전달합니다.

Query Parameters

파라미터	타입	필수	설명
page	integer	❌	조회할 페이지 번호입니다. 1부터 시작하며, 지정하지 않으면 첫 번째 페이지가 반환됩니다. (기본값: 1)
limit	integer	❌	한 페이지에 포함될 리소스 개수입니다. 최소 1, 최대 100까지 설정 가능합니다. (기본값: 20)
sort	string	❌	결과 정렬 기준 필드입니다. created_at(생성일 기준) 또는 updated_at(수정일 기준)을 지정할 수 있으며, 기본적으로 내림차순(최신순)으로 정렬됩니다.

Response (200 OK)

{
  "status": "success",
  "data": [
    {
      "id": "res_123",
      "name": "리소스 이름",
      "created_at": "2026-01-04T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100
  }
}

---

이런 느낌으로 진행했다.

---

과제를 진행하면서 내가 궁금했던점에 대해서 조사한 것이다. 원래는 진짜 더 많은데 너무 많이 물어봐서 정리를 못했다. 이점을 통해 내가 모르는점이 진짜 많다는 것이다

궁금한 점

1. REST API 에서 Query Parameter와 Path Parameter의 차이?
   • Path Parameter : 경로 변수(리소스 자체를 식별하기 위해 URL 경로에 포함된다. 즉 “어떤대상인가?” 에 대한 정보 , 특정 리소스를 정확히 식별 할 때
   • Query Parameter : 리소스를 어떻게 조회할지 조건을 추가 즉, “어떤 방식으로? 어떤 조건으로?”, 조회조건/옵션/부가 정보가 필요할 때
2. Query Parameter의 필수 여부의 판단을 뭘로하는가?
   • 없어도 API 목적이 성립하면 ‘선택’,
     없으면 동작 자체가 불가능하면 ‘필수’다.
3. Request Header의 필수 여부 판단?
   • 이 값이 없으면 서버가 ‘요청을 이해하거나 처리’할 수 있는가?
4. Request Header 와 Request Body는 무엇인가?
   • Request Header : 서버가 요청을 어떻게 처리 하는지 알려주는 정보
   • Request Body: 서버가 실제로 처리할 데이터
5. Response는?
   • 서버가 요청을 받고 처리한 뒤 성공했는지, 실패 했는지, 결과가 무엇인지 알려주는 것

---

회고록

Keep : 현재 만족하고 있는 부분, 계속 이어나갔으면 하는 부분
Problem : 불편하게 느끼는 부분, 개선이 필요하다고 느끼는 부분
Try : Problem에 대한 해결책, 다음 회고 때 판별 가능한 것, 당장 실행 가능한것

Keep

현재 만족하는 부분은 몰랐던 부분을 계속 배워나가고 있다는 점이다. REST API도 아예 할 줄 몰랐고 또한 실제로 프로젝트할 때 이렇게 설계를 한다는 점이다. 계속 이렇게 발전해나가는 모습을 계속 이어나갔으면 좋겠다.

Problem

일단 과제 중에 폰 보고 과제의 집중을 못하는 느낌을 많이 받는다. 물론 노래를 바꿀려고 공부하면서 맞는 노래를 찾을려다 보니 그런것 같다. 그리고 과제를 할 때 GPT의 도움을 받고 있다는 것이다. 이런점은 개선이 필요하다고 생각된다.

Try

먼저 폰을 적게 보는 것이다. 집중모드를 통해 휴대폰의 알람을 줄이고 노래도 일단 한번 틀면 그걸로 쭉 듣는 것 이다. GPT는 내가 GPT를 사용하는 이유는 잘모르고 빨리 하려는 이유도 있다고 생각한다. 이젠 그냥 부딪히고 수정한다는 마음가짐으로 틀려도 된다는 생각으로 부딪혀보겠다.