💻

API 명세서

!!!!!Admin 서비스에서 다른 서비스 불러서 ActivityLog 로직 추가로 변경 필요!!!!!

Card Service

URI
Method
Description
담당자
/v1/mycards
Open
GET
모든 내 카드 가져오기
서승주
서승주
/v1/mycards
Open
POST
내 카드 추가하기
서승주
서승주
/v1/mycards/{mycardId}
Open
DELETE
내 카드 삭제하기
서승주
서승주
/v1/cards/search?query={query}
Open
GET
카드 검색하기
andychoi1997@naver.com
최호윤
/v1/cards/benefits/{cardId}
Open
GET
카드 혜택 가져오기
andychoi1997@naver.com
최호윤
Open

Chat Service

Auth Service

URI
Method
Description
Role
/v1/auth/kakao/login?code={code}
Open
POST
카카오 로그인
USER
/v1/auth/refresh
Open
POST
accessToken 재발급
USER
/v1/auth/validate-token
Open
POST
유효성 검사
SYSTEM

Admin Service

URI
Method
MANAGER, ADMIN
Role
/v1/admin/users
Open
GET
모든 유저 조회
ADMIN
/v1/admin/users/{userId}
Open
GET
특정 유저 조회
ADMIN
/v1/admin/users/{userId}
Open
PUT
유저 수정 (username, role)
ADMIN
/v1/admin/users/{userId}
Open
DELETE
유저 삭제
ADMIN
/v1/admin/activity-logs
Open
GET
모든 로그 조회 (isDeleted=false)
ADMIN
/v1/admin/activity-logs/deleted
Open
GET
모든 삭제된 로그 조회 (isDeleted=true)
ADMIN
/v1/admin/activity-logs
Open
POST
로그 생성
ADMIN
/v1/admin/activity-logs/target
Open
GET
특정 대상 모든 로그 조회
ADMIN
/v1/admin/activity-logs/{activityLogId}
Open
GET
특정 작업 로그 조회
ADMIN
/v1/admin/activity-logs/{activityLogId}
Open
DELETE
로그 삭제 (실제 삭제 X isDeleted=true)
ADMIN
/v1/admin/activity-logs/{activityLogId}/restore
Open
PUT
삭제한 로그 복구
ADMIN

Pay Service

Kafka
URI
Method
Description
Client
/v1/pay
Open
GET
자신의 페이 조회
USER
/v1/pay
Open
POST
페이 생성 (최초 생성만)
USER
/v1/pay
Open
PUT
페이 정보 수정 (잔액 충전)
USER
/v1/pay/accounts
Open
GET
자신의 모든 계좌 조회
USER
/v1/pay/accounts/{accountId}
Open
GET
자신의 특정 계좌 조회
USER
/v1/pay/accounts
Open
POST
계좌 연결
USER
/v1/pay/accounts/{accountId}
Open
PUT
자신의 특정 계좌 수정
USER
/v1/pay/accounts/{accountId}
Open
DELETE
자신의 계좌 삭제
USER
/v1/pay/points
Open
GET
자신의 포인트 조회
USER
/v1/pay/points
Open
PUT
자신의 포인트 사용
USER
/v1/pay/settlements
Open
GET
자신의 결제 정산 내역 조회
USER
/v1/pay/settlements/{settlementId}
Open
GET
특정 결제 정산 내역 조회
USER
/v1/pay/payment
Open
POST
결제 요청
SYSTEM
/v1/pay/statistics/daily
Open
GET
자신의 페이 일별 통계 조회
USER
/v1/pay/statistics/daily/{date}
Open
GET
특정 날짜 자신의 페이 일별 통계 조회
USER
/v1/pay/statistics/monthly
Open
GET
자신의 페이 월별 통계 조회
USER
/v1/pay/statistics/monthly/{month}
Open
GET
특정 날짜의 자신의 페이 월별 통계 조회
USER
/v1/admin/pay
Open
GET
모든 페이 조회
ADMIN
/v1/admin/pay/users/{userId}
Open
GET
특정 사용자 페이 조회
ADMIN
/v1/admin/pay/status
Open
PUT
특정 페이 상태 변경 (활성/비활성/정지)
ADMIN
/v1/admin/pay/accounts
Open
GET
모든 계좌 조회
ADMIN
/v1/admin/pay/accounts/users/{userId}
Open
GET
특정 사용자 모든 계좌 조회
ADMIN
/v1/admin/pay/accounts/{accountId}/users/{userId}
Open
PUT
특정 사용자 계좌 수정
ADMIN
/v1/admin/pay/accounts/{accountId}/users/{userId}
Open
DELETE
특정 사용자 계좌 삭제
ADMIN
/v1/admin/pay/points
Open
GET
모든 포인트 조회
ADMIN
/v1/admin/pay/points/users/{userId}
Open
GET
특정 사용자 포인트 조회
ADMIN
/v1/admin/pay/settlements
Open
GET
모든 결제 정산 내역 조회
ADMIN
/v1/admin/pay/settlements/{settlementId}
Open
GET
특정 결제 정산 내역 조회
ADMIN
/v1/admin/pay/settlements/users/{userId}
Open
GET
특정 사용자 모든 정산 내역 조회
ADMIN
/v1/admin/pay/statistics/daily
Open
GET
모든 페이 일별 통계 조회
ADMIN
/v1/admin/pay/statistics/daily/{date}
Open
GET
특정 날짜 모든 일별 통계 조회
ADMIN
/v1/admin/pay/statistics/monthly
Open
GET
모든 페이 월별 통계 조회
ADMIN
/v1/admin/pay/statistics/monthly/{month}
Open
GET
특정 날짜 모든 월별 통계 조회
ADMIN

Funding Service

Pay 결제 시스템
URI
Method
Description
Client
/v1/funding/organizations
Open
GET
누구나 확인 가능 모든 기부사 조회
USER
ADMIN
/v1/funding
Open
GET
누구나 확인 가능 모든 펀딩 조회
USER
ADMIN
/v1/funding/{category}
Open
GET
누구나 확인 가능 카테고리별 펀딩 조회
USER
ADMIN
/v1/funding/{fundingId}
Open
GET
누구나 확인 가능 펀딩 상세 조회
USER
ADMIN
/v1/funding/my-funding
Open
GET
자신의 참여 중 펀딩 조회
USER
/v1/funding/my-funding/{fundingId}
Open
GET
자신의 참여 중 펀딩 상세 조회 (ex. 얼마 참여했는지)
USER
/v1/funding/my-funding
Open
POST
펀딩에 참여
USER
/v1/funding/my-funding/{fundingId}
Open
PUT
자신의 참여 중 펀딩 금액 수정
USER
/v1/admin/funding/organizations
Open
POST
기부사 생성
ADMIN
/v1/admin/funding/organizations/{organizationId}
Open
PUT
기부사 수정
ADMIN
/v1/admin/funding/organizations/{organizationId}
Open
DELETE
기부사 삭제
ADMIN
/v1/admin/funding
Open
POST
펀딩 생성
ADMIN
/v1/admin/funding/{fundingId}
Open
PUT
펀딩 수정
ADMIN
/v1/admin/funding/{fundingId}/status
Open
PUT
펀딩 수정 (상태 변경)
ADMIN
/v1/admin/funding/{fundingId}
Open
DELETE
펀딩 삭제
ADMIN
/v1/admin/funding/{fundingId}?status={status}
Open
GET
상태에 따른 펀딩 조회
ADMIN
/v1/admin/funding/my-funding
Open
GET
모든 참여 중 펀딩 조회
ADMIN
/v1/admin/funding/my-funding/{fundingId}
Open
GET
모든 참여 중 펀딩 상세 조회
ADMIN
/v1/admin/funding/my-funding/users/{userId}
Open
GET
특정 사용자 참여 중 펀딩 조회
ADMIN

Cash Service

URI
Method
Description
Client
/v1/cash/use
Open
POST
캐시 구매
SYSTEM
/v1/cash
Open
GET
현재 캐시 조회
USER
/v1/admin/cash
Open
POST
캐시 단체 지급
ADMIN
/v1/admin/cash/users/{userId}
Open
POST
특정 사용자 캐시 추가
ADMIN
/v1/admin/cash/users/{userId}
Open
GET
특정 사용자 현재 캐시 조회
ADMIN
/v1/admin/cash/users/{userId}
Open
DELETE
특정 사용자 캐시 차감
ADMIN
/v1/admin/cash/events/reward
Open
POST
이벤트 보상 캐시 지급
ADMIN

Item Service

Cash 결제 시스템
URI
Method
USER
Client
/v1/items
Open
GET
누구나 확인 가능 모든 아이템 조회
USER
ADMIN
/v1/items/{category}
Open
GET
누구나 확인 가능 카테고리별 아이템 조회
USER
ADMIN
/v1/items/my-items
Open
GET
자신의 모든 내 아이템 조회
USER
/v1/items/my-items/purchase
Open
POST
내 아이템 생성(아이템 구매)
USER
/v1/items/my-items/using-items
Open
GET
자신의 모든 사용중 내 아이템 조회
USER
/v1/items/my-items/using-items
Open
POST
사용중 내 아이템 생성
USER
/v1/items/my-items/using-items/{usingItemId}
Open
PUT
사용중 내 아이템 위치 변경
USER
/v1/items/my-items/using-items/{usingItemId}
Open
DELETE
사용중 내 아이템 삭제 (사용X)
USER
/v1/admin/items
Open
POST
아이템 생성
ADMIN
/v1/admin/items/{itemId}
Open
PUT
아이템 수정
ADMIN
/v1/admin/items/{itemId}
Open
DELETE
아이템 삭제
ADMIN
/v1/admin/items/my-items
Open
GET
모든 내 아이템 조회
ADMIN
/v1/admin/items/my-itmes/{myItemId}
Open
DELETE
모든 내 아이템 삭제
ADMIN
/v1/admin/items/my-items/users/{userId}
Open
GET
특정 사용자 모든 내 아이템 조회
ADMIN
/v1/admin/items/my-items/using-items
Open
GET
모든 사용중 내 아이템 조회
ADMIN
/v1/admin/items/my-items/using-items/{usingItemId}
Open
PUT
모든 사용중 내 아이템 위치 변경
ADMIN
/v1/admin/items/my-items/using-items/{usingItemId}
Open
DELETE
모든 사용중 내 아이템 삭제
ADMIN
/v1/admin/items/my-items/using-items/users/{userId}
Open
GET
특정 사용자 모든 사용중 아이템 조회
ADMIN

Payment Service

URI
Method
Description
Role
/v1/payments
Open
GET
자신의 모든 결제 조회
USER
/v1/payments/{paymentId}
Open
GET
자신의 특정 결제만 조회
USER
/v1/payments
Open
POST
결제 요청
USER
/v1/admin/payments
Open
GET
모든 결제 조회
ADMIIN
/v1/admin/payments/{paymentId}
Open
GET
특정 결제 조회
ADMIIN
/v1/admin/payments/{paymentId}
Open
PUT
특정 결제 상태 변경 (승인/거절)
ADMIIN
/v1/admin/payments/user/{userId}
Open
GET
특정 사용자 결제 조회
ADMIIN

Transaction Service

Refund Service

URI
Method
Description
Role
/v1/refunds
Open
GET
자신의 모든 환불 조회
USER
/v1/refunds/{refundId}
Open
GET
자신의 특정 환불만 조회
USER
/v1/refunds
Open
POST
환불 요청
USER
/v1/refunds/{refundId}/reason
Open
PUT
자신의 환불 요청 변경 (사유 변경)
USER
/v1/refunds/cancellations
Open
GET
자신의 모든 취소 조회
USER
/v1/refunds/cancellations/{cancellationId}
Open
GET
자신의 특정 취소만 조회
USER
/v1/refunds/cancellations
Open
POST
취소 요청
USER
/v1/refunds/cancellations/{cancellationId}/reason
Open
PUT
자신의 취소 요청 변경 (사유 변경)
USER
/v1/admin/refunds
Open
GET
모든 환불 조회
ADMIN
/v1/admin/refunds/{refundId}
Open
GET
특정 환불 조회
ADMIN
/v1/admin/refunds/{refundId}
Open
PUT
특정 환불 상태 변경 (승인/거절)
ADMIN
/v1/admin/refunds/users/{userId}
Open
GET
특정 사용자 환불 조회
ADMIN
/v1/admin/refunds/cancellations
Open
GET
모든 취소 조회
ADMIN
/v1/admin/refunds/cancellations/{cancellationId}
Open
GET
특정 취소 조회
ADMIN
/v1/admin/refunds/cancellations/{cancellationId}
Open
PUT
특정 결제 취소 변경 (승인/거절)
ADMIN
/v1/admin/refunds/cancellations/users/{userId}
Open
GET
특정 사용자 취소 조회
ADMIN

Settlement Service

URI
Method
Description
Role
/v1/settlements
Open
GET
자신의 모든 정산 조회
USER
/v1/settlements/{settlementId}
Open
GET
자신의 특정 정산만 조회
USER
/v1/admin/settlements
Open
GET
모든 정산 조회
ADMIN
/v1/admin/settlements/{settlementId}
Open
GET
특정 정산 조회
ADMIN
/v1/admin/settlements/{settlementId}
Open
PUT
정산 상태 변경
ADMIN
/v1/admin/settlements/users/{userId}
Open
GET
특정 사용자 정산 조회
ADMIN

Schedule Service

URI
Method
Description
Client
/v1/schedules
Open
GET
모든 스케줄 조회
SpringBoot
/v1/schedules
Open
POST
스케줄 생성
React
/v1/schedules/{scheduleId}
Open
GET
특정 스케줄 조회
React
/v1/schedules/{schedulesId}
Open
PUT
특정 스케줄 업데이트
SpringBoot

ApiUser Service

URI
Method
Description
Role
/v1/admin/api-users
Open
GET
모든 사용자 조회
ADMIN
/v1/admin/api-users/{sellerId}
Open
GET
특정 사용자 정보 조회
ADMIN
/v1/admin/api-users
Open
POST
사용자 추가
ADMIN
/v1/admin/api-users/{sellerId}
Open
PUT
사용자 업데이트
ADMIN
/v1/admin/api-users/{sellerId}
Open
DELETE
사용자 삭제
ADMIN

Notification Service

양방향 통신 필요 X → SSE
URI
Method
Description
Client
/v1/notifications
Open
GET
모든 알림 리스트 조회
USER
/v1/notifications
Open
POST
새 알림 생성
ADMIN
/v1/notifications/{notificationId}
Open
GET
특정 알림 상태 조회
USER
ADMIN
/v1/notifications/{notificationId}
Open
PUT
알림 업데이트(알림 읽음)
USER
/v1/admin/notifications
Open
POST
알림 전송
ADMIN
Open

SystemLog Service

⇒ 각 서비스의 log 파일
URI
Method
Description
Role
/v1/system-logs
Open
GET
모든 로그 조회 (isDeleted=false)
ADMIN
/v1/system-logs/deleted
Open
GET
모든 삭제된 로그 조회 (isDeleted=true)
ADMIN
/v1/system-logs
Open
POST
로그 생성
ADMIN
/v1/system-logs/{systemLogId}
Open
GET
특정 로그 조회
ADMIN
/v1/system-logs/target
Open
GET
특정 대상 모든 로그 조회
ADMIN
/v1/system-logs/{systemLogId}
Open
GET
특정 작업 로그 조회
ADMIN
/v1/system-logs/{systemLogId}
Open
PUT
삭제 로그 복구
ADMIN
/v1/system-logs/{systemLogId}/restore
Open
DELETE
로그 삭제 (실제 삭제 X isDeleted=true)
ADMIN
/v1/system-logs/{systemLogId}/purge
Open
DELETE
영구 삭제
ADMIN