HomeAboutMeBlogGuest
© 2025 Sejin Cha. All rights reserved.
Built with Next.js, deployed on Vercel
♥️
2기 최종 프로젝트 팀별 공간/
💸
10원모아10조❗️/
📽️
API 명세
📽️

API 명세

URL prefix : /api/v1/
EC2 서버 : http://3.39.184.232 (main: 80, dev:8080)
 

테스트 유저 정보

id : test2@test.com or test3@test.com
pw : test1234

프론트와 같이 논의해야할 부분

  • 사용자 정보 수정을 닉네임, 비밀번호 변경 따로할지 같이 할지 → 따로 하는게 더 좋은 UX
  • 일일 페이지 에서 무한 스크롤로 구현할 지 어떻게 할지 논의. 마우스 휠이 어느 특정 지점까지 갔을 때 이벤트 발생해서 API 날리는 식으로 구현됨

HTTP Status Code

성공(200대)

  • 200
  • 201(Created)
  • 204(No Content)

클라이언트 오류(400대)

  • 400 Bad Request
  • 401 Unauthorized(인증 안된)
  • 403 Forbidden (권한 없음)
  • 404 Not Found

Authentication Header (인증 필요 API)

Authorization : “accessToken”
 
유저
기능
인증 필요
URL
Method
작업여부
담당자
API 완료 예정 날짜
API 연결여부
사용자 회원가입
인증 필요
/users
POST
작업여부
얀주
다나
API 연결여부
사용자 로그인
인증 필요
/users/login
POST
작업여부
얀주
다나
API 연결여부
토큰 재발급
인증 필요
/users/refresh
POST
작업여부
얀주
다나
2022-08-04
API 연결여부
google 로그인
/oauth2/authorize/google
href
작업여부
얀주
2022-08-08 or 08-09
사용자 정보 조회
인증 필요
/users
GET
작업여부
윌리엄
사용자 로그아웃
인증 필요
/users/logout
POST
작업여부
얀주
회원탈퇴
인증 필요
/users/delete
DELETE
작업여부
얀주
비밀번호 확인
인증 필요
/users/password/check
POST
작업여부
얀주
사용자 닉네임
인증 필요
/users/username
PATCH
얀주
사용자 비밀번호 수정
인증 필요
/users/password
PATCH
얀주
이메일 인증 시 이메일 전송
/users/send-email
POST
얀주
다나
가계부
기능
인증 필요
URL
Method
작업여부
담당자
API 연결여부
수입등록
인증 필요
/incomes
POST
작업여부
캉테
비올레
API 연결여부
수입수정
인증 필요
/incomes/{incomeId}
PUT
작업여부
캉테
비올레
API 연결여부
수입 상세 조회
인증 필요
/incomes/{incomeId}
GET
작업여부
캉테
비올레
API 연결여부
수입 삭제
인증 필요
/incomes/{incomeId}
DELETE
작업여부
캉테
비올레
API 연결여부
지출등록
인증 필요
/expenditures
POST
작업여부
루체
비올레
API 연결여부
지출 수정
인증 필요
/expenditures/{expenditureId}
PUT
작업여부
루체
비올레
API 연결여부
지출 상세 조회
인증 필요
/expenditures/{expenditureId}
GET
작업여부
루체
비올레
API 연결여부
지출 삭제
인증 필요
/expenditures/{expenditureId}
DELETE
작업여부
루체
비올레
API 연결여부
월별 합계 API
인증 필요
/account-book/sum/month/{date}
GET
작업여부
루체
다나
API 연결여부
일일 상세 내역 조회(paging)
인증 필요
/account-book/daily/{date}
GET
작업여부
루체
다나
API 연결여부
월별 내역 조회
인증 필요
/account-book/month/{year}
GET
작업여부
루체
다나
API 연결여부
연간 합계 API
인증 필요
/account-book/sum/year/{year}
GET
작업여부
루체
다나
API 연결여부
검색 API
인증 필요
/account-book/search ?categories=1,2,3 &minprice=0 &maxprice=20000 &start=2022-10-22 &end=2022-10-30 &content=내용 &size=2 &page=1
GET
작업여부
윌리엄
비올레
API 연결여부
검색 데이터 합계 API
인증 필요
/account-book/search/sum/ ?categories=1,2,3 &minprice=0 &maxprice=20000 &start=2022-10-22 &end=2022-10-30 &content=내용
GET
작업여부
윌리엄
비올레
API 연결여부
달력 API
인증 필요
/account-book/calendar?year=2022&month=8
GET
작업여부
루체
제닛
API 연결여부
 
 
통계
기능
인증 필요
URL
Method
작업여부
담당자
API 연결여부
API 완료예정
통계 데이터 조회
인증 필요
statistics?year={year}&month={month}
GET
작업여부
제닛
캉테
Aug 8, 2022
 
카테고리
기능
인증 필요
URL
Method
작업여부
담당자
API 연결여부
카테고리 전체 조회
인증 필요
/categories?kind=income
GET
작업여부
윌리엄
비올레
API 연결여부
카테고리 등록
인증 필요
/categories
POST
작업여부
윌리엄
비올레
API 연결여부
카테고리 삭제
인증 필요
/categories/{categoryId}
DELETE
작업여부
윌리엄
비올레
API 연결여부
카테고리 수정
인증 필요
/categories/{categoryId}
PATCH
작업여부
윌리엄
비올레
API 연결여부

예산 페이지

예산
기능
인증 필요
URL
Method
작업여부
담당자
API 연결여부
예산 데이터 등록 or 수정
인증 필요
/budgets
PUT
작업여부
소니
캉테
월 별 예산 등록 정보 조회
인증 필요
/budgets?registerDate={yyyy-mm}
GET
작업여부
소니
캉테
월, 연별 카테고리별 예산통계 조회
인증 필요
/budgets/statistics?year={yyyy}&month={mm}
GET
작업여부
소니
캉테