Bank API

사용자 은행 API 키 발급

HTTP Request

POST /api/bank/user/key/mine702@naver.com HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json
Content-Length: 284

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "userEmail" : "mine702@naver.com",
    "userKey" : "13cefdcf-494f-4092-bf96-d5f4dbb634c4",
    "created" : "2024-03-04T12:41:30.921299+09:00",
    "modified" : "2024-03-04T12:41:30.921299+09:00"
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.userEmail

String

유저 Email

data.userKey

String

유저 API 키

data.created

String

생성 일자

data.modified

String

수정 일자

사용자 은행 API 키 조회

HTTP Request

GET /api/bank/user/key/mine702@naver.com HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json
Content-Length: 284

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "userEmail" : "mine702@naver.com",
    "userKey" : "13cefdcf-494f-4092-bf96-d5f4dbb634c4",
    "created" : "2024-03-04T12:41:30.921299+09:00",
    "modified" : "2024-03-04T12:41:30.921299+09:00"
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.userEmail

String

유저 Email

data.userKey

String

유저 API 키

data.created

String

생성 일자

data.modified

String

수정 일자

사용자 은행 계좌 목록 조회

HTTP Request

GET /api/bank/user/account/mine702@naver.com HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json
Content-Length: 441

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "header" : {
      "responseCode" : "H0000",
      "responseMessage" : "정상처리 되었습니다."
    },
    "rec" : [ {
      "bankCode" : "001",
      "bankName" : "한국은행",
      "accountNo" : "0016826085496269"
    }, {
      "bankCode" : "002",
      "bankName" : "산업은행",
      "accountNo" : "0028889135848149"
    } ]
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.header

Object

응답 데이터 헤더

data.header.responseCode

String

응답 코드

data.header.responseMessage

String

응답 메시지

data.rec

Array

응답 데이터 REC

data.rec[].bankCode

String

응답 데이터 은행 코드

data.rec[].bankName

String

응답 데이터 은행 이름

data.rec[].accountNo

String

응답 데이터 계좌 번호

사용자 은행 계좌 거래 내역 조회

HTTP Request

POST /api/bank/user/account/transaction HTTP/1.1
Content-Type: application/json
Content-Length: 185
Host: localhost:8080

{
  "userEmail" : "mine702@naver.com",
  "bankCode" : "001",
  "transactionType" : "A",
  "accountNo" : "0014375203694183",
  "startDate" : "20240101",
  "endDate" : "20241231"
}

Request Fields

Path Type Optional Description

userEmail

String

사용자 이메일

bankCode

String

조회 하고 싶은 은행 코드 번호

transactionType

String

거래 내역 조회 정보

accountNo

String

거래 내역 조회 계좌 번호

startDate

String

시작 날짜

endDate

String

종료 날짜

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 896

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "header" : {
      "responseCode" : "H0000",
      "responseMessage" : "정상처리 되었습니다."
    },
    "rec" : [ {
      "transactionUniqueNo" : "107",
      "transactionDate" : "20240304",
      "transactionType" : "1",
      "transactionBalance" : "10000000",
      "transactionSummary" : "입금합니다"
    }, {
      "transactionUniqueNo" : "108",
      "transactionDate" : "20240304",
      "transactionType" : "2",
      "transactionBalance" : "1000000",
      "transactionSummary" : "출금합니다"
    }, {
      "transactionUniqueNo" : "109",
      "transactionDate" : "20240304",
      "transactionType" : "2",
      "transactionBalance" : "1000000",
      "transactionSummary" : "출금이체 계좌",
      "transactionAccountNo" : "0028889135848149"
    } ]
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.header

Object

응답 데이터 헤더

data.header.responseCode

String

응답 코드

data.header.responseMessage

String

응답 메시지

data.rec

Array

응답 데이터 REC

data.rec[].transactionUniqueNo

String

응답 데이터 계좌 내역 유일번호

data.rec[].transactionDate

String

응답 데이터 계좌 내역 날짜

data.rec[].transactionType

String

응답 데이터 계좌 내역 입 출금 조회

data.rec[].transactionBalance

String

응답 데이터 계좌 내역 금액

data.rec[].transactionSummary

String

응답 데이터 계좌 내역 문구

data.rec[].transactionAccountNo

String

O

응답 데이터 출금 이체 계좌 번호

사용자 주식(증권) 계좌 발급

HTTP Request

POST /api/bank/user/stock/account/mine702@naver.com HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json
Content-Length: 288

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "header" : {
      "responseCode" : "H0000",
      "responseMessage" : "정상처리 되었습니다."
    },
    "rec" : {
      "bankCode" : "004",
      "accountNo" : "0016826085496269"
    }
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.header

Object

응답 데이터 헤더

data.header.responseCode

String

응답 코드

data.header.responseMessage

String

응답 메시지

data.rec

Object

응답 데이터 REC

data.rec.bankCode

String

응답 데이터 계좌 은행 코드

data.rec.accountNo

String

응답 데이터 계좌 번호

사용자 계좌 이체

HTTP Request

POST /api/bank/user/accountTransfer HTTP/1.1
Content-Type: application/json
Content-Length: 345
Host: localhost:8080

{
  "userEmail" : "mine702@naver.com",
  "depositBankCode" : "004",
  "depositAccountNo" : "0028889135848149",
  "transactionBalance" : "10000",
  "withdrawalBankCode" : "001",
  "withdrawalAccountNo" : "0016826085496269",
  "depositTransactionSummary" : "입금이체 계좌",
  "withdrawalTransactionSummary" : "출금이체 계좌"
}

Request Fields

Path Type Optional Description

userEmail

String

유저 이메일

depositBankCode

String

입금 계좌 은행 코드

depositAccountNo

String

입금 계좌 번호

transactionBalance

String

계좌이체 금액

withdrawalBankCode

String

입금 계좌 은행 코드

withdrawalAccountNo

String

출금 계좌 번호

depositTransactionSummary

String

O

입금 문구

withdrawalTransactionSummary

String

O

출금 문구

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 79

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : null
}

주식 구매

HTTP Request

POST /api/bank/user/drawingTransfer HTTP/1.1
Content-Type: application/json
Content-Length: 191
Host: localhost:8080

{
  "userEmail" : "mine702@naver.com",
  "bankCode" : "004",
  "accountNo" : "0013386179553277",
  "transactionBalance" : "34000",
  "transactionSummary" : "에스케이 하이닉스"
}

Request Fields

Path Type Optional Description

userEmail

String

유저 이메일

bankCode

String

출금 계좌 은행 코드

accountNo

String

출금 계좌 번호

transactionBalance

String

출금 금액

transactionSummary

String

구매 아이템

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 79

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : null
}

더미데이터 생성

HTTP Request

POST /api/bank/user/dummy/mine702@naver.com HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json
Content-Length: 79

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : null
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Null

응답 데이터

Team API

팀 생성

HTTP Request

POST /api/team/create HTTP/1.1
Content-Type: application/json
Content-Length: 116
Host: localhost:8080

{
  "teamName" : "팀이름",
  "teamIsAutoConfirm" : false,
  "teamLeaderId" : 1,
  "teamInfo" : "팀소개"
}

Request Fields

Path Type Optional Description

teamName

String

팀 이름

teamIsAutoConfirm

Boolean

팀 가입 자동 승인 여부

teamLeaderId

Number

팀장 ID

teamInfo

String

팀장 소개

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 776

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "teamId" : 1,
    "chatRoomId" : 1,
    "teamName" : "팀이름",
    "teamLeaderId" : 1,
    "teamInfo" : "팀 한줄소개",
    "teamScore" : 0,
    "teamRankRealtime" : 1,
    "teamIsAutoConfirm" : true,
    "teamLastTotalExpenses" : 30000,
    "teamThisTotalExpenses" : 200000,
    "teamLastEachTotalExpenses" : [ {
      "date" : [ 2024, 3, 28 ],
      "totalAmount" : 300000
    } ],
    "teamThisEachTotalExpenses" : [ {
      "date" : [ 2024, 3, 28 ],
      "totalAmount" : 300000
    } ],
    "members" : [ {
      "memberId" : 0,
      "memberNickname" : "멤버 닉네임",
      "memberLastTotalExpenses" : 0,
      "memberThisTotalExpenses" : 0
    } ]
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.teamId

Number

팀 ID

data.chatRoomId

Number

팀 채팅방 ID

data.teamName

String

팀 명

data.teamLeaderId

Number

팀장 ID

data.teamInfo

String

팀 한줄 소개

data.teamScore

Number

팀 포인트

data.teamRankRealtime

Number

팀 실시간 랭킹

data.teamIsAutoConfirm

Boolean

팀 가입 자동 승인 여부

data.teamLastTotalExpenses

Number

지난주 총 지출액

data.teamThisTotalExpenses

Number

이번주 총 지출액

data.teamLastEachTotalExpenses

Array

지난주 일자 별 총 지출액

data.teamLastEachTotalExpenses[].date

Array

일자

data.teamLastEachTotalExpenses[].totalAmount

Number

지출액

data.teamThisEachTotalExpenses

Array

이번주 일자 별 총 지출액

data.teamThisEachTotalExpenses[].date

Array

일자

data.teamThisEachTotalExpenses[].totalAmount

Number

지출액

data.members

Array

팀 멤버

data.members[].memberId

Number

멤버 ID

data.members[].memberNickname

String

멤버 닉네임

data.members[].memberLastTotalExpenses

Number

멤버 지난주 지출 총액

data.members[].memberThisTotalExpenses

Number

멤버 이번주 지출 총액

팀명 중복 체크

HTTP Request

POST /api/team/create/teamName1 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 80

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : false
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Boolean

중복 여부

팀 주간 랭킹 조회

HTTP Request

GET /api/team/rank/weekly/2 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1788

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "content" : [ {
      "teamRanks" : [ {
        "teamName" : "팀이름1",
        "rankDate" : [ 2024, 4, 1 ],
        "rankNum" : 1,
        "teamScore" : 600,
        "rewardPoint" : 1000
      }, {
        "teamName" : "팀이름2",
        "rankDate" : [ 2024, 4, 1 ],
        "rankNum" : 2,
        "teamScore" : 500,
        "rewardPoint" : 500
      }, {
        "teamName" : "팀이름3",
        "rankDate" : [ 2024, 4, 1 ],
        "rankNum" : 3,
        "teamScore" : 400,
        "rewardPoint" : 400
      }, {
        "teamName" : "팀이름4",
        "rankDate" : [ 2024, 4, 1 ],
        "rankNum" : 4,
        "teamScore" : 300,
        "rewardPoint" : 300
      }, {
        "teamName" : "팀이름5",
        "rankDate" : [ 2024, 4, 1 ],
        "rankNum" : 5,
        "teamScore" : 200,
        "rewardPoint" : 200
      }, {
        "teamName" : "팀이름6",
        "rankDate" : [ 2024, 4, 1 ],
        "rankNum" : 6,
        "teamScore" : 100,
        "rewardPoint" : 0
      } ],
      "myTeamName" : "팀이름2",
      "myTeamRankNum" : 2,
      "myTeamScore" : 500,
      "myTeamRewardPoint" : 500
    } ],
    "pageable" : {
      "pageNumber" : 0,
      "pageSize" : 6,
      "sort" : {
        "empty" : true,
        "sorted" : false,
        "unsorted" : true
      },
      "offset" : 0,
      "unpaged" : false,
      "paged" : true
    },
    "last" : true,
    "totalPages" : 1,
    "totalElements" : 1,
    "size" : 6,
    "number" : 0,
    "sort" : {
      "empty" : true,
      "sorted" : false,
      "unsorted" : true
    },
    "first" : true,
    "numberOfElements" : 1,
    "empty" : false
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.content

Array

응답 데이터 배열

data.content[].teamRanks

Array

팀 랭킹

data.content[].teamRanks[].teamName

String

팀 이름

data.content[].teamRanks[].rankDate

Array

랭킹 집계 날짜

data.content[].teamRanks[].rankNum

Number

랭킹 순위

data.content[].teamRanks[].teamScore

Number

팀 점수

data.content[].teamRanks[].rewardPoint

Number

보상 포인트

data.content[].myTeamName

String

조회하는 유저의 팀 이름

data.content[].myTeamRankNum

Number

조회하는 유저의 팀 순위

data.content[].myTeamScore

Number

조회하는 유저의 팀 점수

data.content[].myTeamRewardPoint

Number

조회하는 유저의 팀 보상 포인트

data.pageable

Object

응답 데이터 페이지 정보

data.pageable.pageNumber

Number

응답 데이터 페이지 현재 페이지 넘버

data.pageable.pageSize

Number

응답 데이터 페이지 현재 페이지 크기

data.pageable.sort

Object

응답 데이터 페이지 현재 페이지 정렬

data.pageable.sort.empty

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.unsorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.sorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.offset

Number

응답 데이터 페이지 offset

data.pageable.paged

Boolean

응답 데이터 페이지 paged

data.pageable.unpaged

Boolean

응답 데이터 페이지 unpaged

data.last

Boolean

응답 데이터 마지막 페이지 여부

data.totalElements

Number

응답 데이터 총 숫자

data.totalPages

Number

응답 데이터 총 페이지

data.first

Boolean

응답 데이터 첫페이지 여부

data.numberOfElements

Number

응답 데이터 크기

data.size

Number

응답 데이터 크기

data.number

Number

응답 데이터 페이지 넘버

data.sort

Object

응답 데이터 정렬

data.sort.empty

Boolean

응답 데이터 정렬 empty

data.sort.unsorted

Boolean

응답 데이터 정렬 unsorted

data.sort.sorted

Boolean

응답 데이터 정렬 sorted

data.empty

Boolean

응답 데이터 empty

팀 실시간 랭킹 조회

HTTP Request

GET /api/team/rank/realtime/2 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1630

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "content" : [ {
      "teamRanks" : [ {
        "teamRanks" : null,
        "teamName" : "팀이름1",
        "teamRankRealtime" : 1,
        "teamScoreRealtime" : 600
      }, {
        "teamRanks" : null,
        "teamName" : "팀이름2",
        "teamRankRealtime" : 2,
        "teamScoreRealtime" : 500
      }, {
        "teamRanks" : null,
        "teamName" : "팀이름3",
        "teamRankRealtime" : 3,
        "teamScoreRealtime" : 400
      }, {
        "teamRanks" : null,
        "teamName" : "팀이름4",
        "teamRankRealtime" : 4,
        "teamScoreRealtime" : 300
      }, {
        "teamRanks" : null,
        "teamName" : "팀이름5",
        "teamRankRealtime" : 5,
        "teamScoreRealtime" : 200
      }, {
        "teamRanks" : null,
        "teamName" : "팀이름6",
        "teamRankRealtime" : 6,
        "teamScoreRealtime" : 100
      } ],
      "teamName" : "팀이름1",
      "teamRankRealtime" : 1,
      "teamScoreRealtime" : 600
    } ],
    "pageable" : {
      "pageNumber" : 0,
      "pageSize" : 6,
      "sort" : {
        "empty" : true,
        "sorted" : false,
        "unsorted" : true
      },
      "offset" : 0,
      "unpaged" : false,
      "paged" : true
    },
    "last" : true,
    "totalPages" : 1,
    "totalElements" : 1,
    "size" : 6,
    "number" : 0,
    "sort" : {
      "empty" : true,
      "sorted" : false,
      "unsorted" : true
    },
    "first" : true,
    "numberOfElements" : 1,
    "empty" : false
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.content

Array

응답 데이터 배열

data.content[].teamRanks[]

Array

팀 실시간 랭킹정보

data.content[].teamRanks[].teamRanks

Null

팀 랭킹

data.content[].teamRanks[].teamName

String

팀 이름

data.content[].teamRanks[].teamRankRealtime

Number

실시간 랭킹 순위

data.content[].teamRanks[].teamScoreRealtime

Number

실시간 팀 점수

data.content[].teamName

String

조회하는 유저의 팀 이름

data.content[].teamRankRealtime

Number

조회하는 유저의 실시간 순위

data.content[].teamScoreRealtime

Number

조회하는 유저의 실시간 점수

data.pageable

Object

응답 데이터 페이지 정보

data.pageable.pageNumber

Number

응답 데이터 페이지 현재 페이지 넘버

data.pageable.pageSize

Number

응답 데이터 페이지 현재 페이지 크기

data.pageable.sort

Object

응답 데이터 페이지 현재 페이지 정렬

data.pageable.sort.empty

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.unsorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.sorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.offset

Number

응답 데이터 페이지 offset

data.pageable.paged

Boolean

응답 데이터 페이지 paged

data.pageable.unpaged

Boolean

응답 데이터 페이지 unpaged

data.last

Boolean

응답 데이터 마지막 페이지 여부

data.totalElements

Number

응답 데이터 총 숫자

data.totalPages

Number

응답 데이터 총 페이지

data.first

Boolean

응답 데이터 첫페이지 여부

data.numberOfElements

Number

응답 데이터 크기

data.size

Number

응답 데이터 크기

data.number

Number

응답 데이터 페이지 넘버

data.sort

Object

응답 데이터 정렬

data.sort.empty

Boolean

응답 데이터 정렬 empty

data.sort.unsorted

Boolean

응답 데이터 정렬 unsorted

data.sort.sorted

Boolean

응답 데이터 정렬 sorted

data.empty

Boolean

응답 데이터 empty

팀 전체 조회 + 검색

HTTP Request

GET /api/team?keyword=name&page=0&size=4 HTTP/1.1
Content-Type: application/json
Host: localhost:8080
Parameter Description

keyword

팀 이름 검색 키워드

page

페이지 넘버 요청

size

페이지 크기 요청

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1478

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "content" : [ {
      "teamId" : 1,
      "teamName" : "teamName1",
      "teamMembersNum" : 4,
      "teamLeaderNickname" : "리더 닉네임1",
      "teamIsAutoConfirm" : false,
      "teamInfo" : "팀소개1"
    }, {
      "teamId" : 2,
      "teamName" : "teamName2",
      "teamMembersNum" : 6,
      "teamLeaderNickname" : "리더 닉네임2",
      "teamIsAutoConfirm" : true,
      "teamInfo" : "팀소개2"
    }, {
      "teamId" : 3,
      "teamName" : "teamName3",
      "teamMembersNum" : 6,
      "teamLeaderNickname" : "리더 닉네임3",
      "teamIsAutoConfirm" : false,
      "teamInfo" : "팀소개3"
    }, {
      "teamId" : 4,
      "teamName" : "teamName4",
      "teamMembersNum" : 5,
      "teamLeaderNickname" : "리더 닉네임4",
      "teamIsAutoConfirm" : false,
      "teamInfo" : "팀소개4"
    } ],
    "pageable" : {
      "pageNumber" : 0,
      "pageSize" : 4,
      "sort" : {
        "empty" : true,
        "sorted" : false,
        "unsorted" : true
      },
      "offset" : 0,
      "unpaged" : false,
      "paged" : true
    },
    "last" : true,
    "totalPages" : 1,
    "totalElements" : 4,
    "size" : 4,
    "number" : 0,
    "sort" : {
      "empty" : true,
      "sorted" : false,
      "unsorted" : true
    },
    "first" : true,
    "numberOfElements" : 4,
    "empty" : false
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.content

Array

응답 데이터 배열

data.content[].teamId

Number

팀 ID

data.content[].teamName

String

팀 이름

data.content[].teamMembersNum

Number

팀 인원 수

data.content[].teamLeaderNickname

String

팀 리더 닉네임

data.content[].teamIsAutoConfirm

Boolean

팀 가입 자동 승인 여부

data.content[].teamInfo

String

팀 한줄 소개

data.pageable

Object

응답 데이터 페이지 정보

data.pageable.pageNumber

Number

응답 데이터 페이지 현재 페이지 넘버

data.pageable.pageSize

Number

응답 데이터 페이지 현재 페이지 크기

data.pageable.sort

Object

응답 데이터 페이지 현재 페이지 정렬

data.pageable.sort.empty

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.unsorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.sorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.offset

Number

응답 데이터 페이지 offset

data.pageable.paged

Boolean

응답 데이터 페이지 paged

data.pageable.unpaged

Boolean

응답 데이터 페이지 unpaged

data.last

Boolean

응답 데이터 마지막 페이지 여부

data.totalElements

Number

응답 데이터 총 숫자

data.totalPages

Number

응답 데이터 총 페이지

data.first

Boolean

응답 데이터 첫페이지 여부

data.numberOfElements

Number

응답 데이터 크기

data.size

Number

응답 데이터 크기

data.number

Number

응답 데이터 페이지 넘버

data.sort

Object

응답 데이터 정렬

data.sort.empty

Boolean

응답 데이터 정렬 empty

data.sort.unsorted

Boolean

응답 데이터 정렬 unsorted

data.sort.sorted

Boolean

응답 데이터 정렬 sorted

data.empty

Boolean

응답 데이터 empty

팀 상세 조회

HTTP Request

GET /api/team/1 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 932

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "teamId" : 1,
    "chatRoomId" : 1,
    "teamName" : "팀이름",
    "teamLeaderId" : 1,
    "teamInfo" : "팀 한줄소개",
    "teamScore" : 150,
    "teamRankRealtime" : 1,
    "teamIsAutoConfirm" : true,
    "teamLastTotalExpenses" : 30000,
    "teamThisTotalExpenses" : 200000,
    "teamLastEachTotalExpenses" : [ {
      "date" : [ 2024, 3, 28 ],
      "totalAmount" : 300000
    } ],
    "teamThisEachTotalExpenses" : [ {
      "date" : [ 2024, 3, 28 ],
      "totalAmount" : 300000
    } ],
    "members" : [ {
      "memberId" : 0,
      "memberNickname" : "멤버 닉네임",
      "memberLastTotalExpenses" : 0,
      "memberThisTotalExpenses" : 0
    }, {
      "memberId" : 0,
      "memberNickname" : "멤버 닉네임",
      "memberLastTotalExpenses" : 0,
      "memberThisTotalExpenses" : 0
    } ]
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.teamId

Number

팀 ID

data.chatRoomId

Number

팀 채팅방 ID

data.teamName

String

팀 명

data.teamLeaderId

Number

팀장 ID

data.teamInfo

String

팀 한줄 소개

data.teamScore

Number

팀 포인트

data.teamRankRealtime

Number

팀 실시간 랭킹

data.teamIsAutoConfirm

Boolean

팀 가입 자동 승인 여부

data.teamLastTotalExpenses

Number

지난주 총 지출액

data.teamThisTotalExpenses

Number

이번주 총 지출액

data.teamLastEachTotalExpenses

Array

지난주 일자 별 총 지출액

data.teamLastEachTotalExpenses[].date

Array

일자

data.teamLastEachTotalExpenses[].totalAmount

Number

지출액

data.teamThisEachTotalExpenses

Array

이번주 일자 별 총 지출액

data.teamThisEachTotalExpenses[].date

Array

일자

data.teamThisEachTotalExpenses[].totalAmount

Number

지출액

data.members

Array

팀 멤버

data.members[].memberId

Number

멤버 ID

data.members[].memberNickname

String

멤버 닉네임

data.members[].memberLastTotalExpenses

Number

멤버 지난주 지출 총액

data.members[].memberThisTotalExpenses

Number

멤버 이번주 지출 총액

다른 팀 상세 조회

HTTP Request

GET /api/team/detail/1 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 220

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "teamName" : "팀 이름",
    "teamInfo" : "팀 한줄 소개",
    "teamLeaderNickname" : "리더 닉네임",
    "lastRank" : 2
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.teamName

String

팀 명

data.teamInfo

String

팀 한줄 소개

data.teamLeaderNickname

String

팀장 닉네임

data.lastRank

Number

가장 마지막 랭크 내역

팀 가입 승인 대기 리스트 조회

HTTP Request

POST /api/team/waitingList HTTP/1.1
Content-Type: application/json
Content-Length: 39
Host: localhost:8080

{
  "teamId" : 1,
  "memberId" : 3
}

Request Fields

Path Type Optional Description

teamId

Number

팀 ID

memberId

Number

리스트 보려는 유저(팀장) ID

HTTP Response

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : [ {
    "memberId" : 3,
    "memberNickname" : "��湲곗옄 �땳�꽕�엫",
    "memberMostCategory" : "臾명솕"
  }, {
    "memberId" : 3,
    "memberNickname" : "��湲곗옄 �땳�꽕�엫",
    "memberMostCategory" : "臾명솕"
  } ]
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Array

응답 데이터

data.[].memberId

Number

유저 ID

data.[].memberNickname

String

유저 닉네임

data.[].memberMostCategory

String

유저 최대 지출 카테고리

팀 정보 수정

HTTP Request

PATCH /api/team/10 HTTP/1.1
Content-Type: application/json
Content-Length: 157
Host: localhost:8080

{
  "memberId" : 100,
  "teamName" : "수정 전 팀이름",
  "teamLeaderId" : 200,
  "teamIsAutoConfirm" : false,
  "teamInfo" : "팀 한줄소개"
}

Request Fields

Path Type Optional Description

memberId

Number

요청 보내는 유저 ID

teamName

String

팀 이름

teamIsAutoConfirm

Boolean

자동가입 승인 여부

teamLeaderId

Number

팀장 ID

teamInfo

String

팀 한줄소개

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 232

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "teamName" : "수정 후 팀이름",
    "teamLeaderId" : 200,
    "teamIsAutoConfirm" : false,
    "teamInfo" : "수정 후 팀 한줄소개"
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.teamName

String

수정 후 팀 명

data.teamLeaderId

Number

수정 후 팀장 ID

data.teamIsAutoConfirm

Boolean

수정 후 자동 가입 승인 여부

data.teamInfo

String

수정 후 팀 소개

팀원 추방

HTTP Request

POST /api/team/ban HTTP/1.1
Content-Type: application/json
Content-Length: 68
Host: localhost:8080

{
  "teamId" : 1,
  "teamLeaderId" : 1,
  "targetMemberId" : 2
}

Request Fields

Path Type Optional Description

teamId

Number

팀 ID

teamLeaderId

Number

요청 보내는 유저 ID

targetMemberId

Number

추방 할 유저 ID

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 90

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : "추방 완료"
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

String

추방 완료 메시지

팀 가입

HTTP Request

POST /api/team/join HTTP/1.1
Content-Type: application/json
Content-Length: 39
Host: localhost:8080

{
  "teamId" : 1,
  "memberId" : 2
}

Request Fields

Path Type Optional Description

teamId

Number

팀 ID

memberId

Number

유저 ID

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 199

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "teamName" : "팀 이름",
    "teamInfo" : "팀 한줄소개",
    "teamScore" : 100,
    "teamLeaderId" : 1
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.teamName

String

팀 이름

data.teamInfo

String

팀 한줄 소개

data.teamScore

Number

팀 포인트

data.teamLeaderId

Number

팀장 ID

팀 가입 승인

HTTP Request

POST /api/team/approve HTTP/1.1
Content-Type: application/json
Content-Length: 39
Host: localhost:8080

{
  "teamId" : 1,
  "memberId" : 1
}

Request Fields

Path Type Optional Description

teamId

Number

팀 ID

memberId

Number

승인 대기 유저 ID

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 97

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : "가입 승인 완료"
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

String

승인 완료 메시지

팀 가입 거절

HTTP Request

POST /api/team/reject HTTP/1.1
Content-Type: application/json
Content-Length: 39
Host: localhost:8080

{
  "teamId" : 1,
  "memberId" : 1
}

Request Fields

Path Type Optional Description

teamId

Number

팀 ID

memberId

Number

승인 대기 유저 ID

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 97

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : "가입 거절 완료"
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

String

거절 완료 메시지

팀 탈퇴

HTTP Request

POST /api/team/leave HTTP/1.1
Content-Type: application/json
Content-Length: 41
Host: localhost:8080

{
  "teamId" : 10,
  "memberId" : 10
}

Request Fields

Path Type Optional Description

teamId

Number

팀 ID

memberId

Number

유저 ID

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 90

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : "탈퇴 완료"
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

String

탈퇴 완료 메시지

팀 삭제

HTTP Request

DELETE /api/team HTTP/1.1
Content-Type: application/json
Content-Length: 41
Host: localhost:8080

{
  "teamId" : 10,
  "memberId" : 10
}

Request Fields

Path Type Optional Description

teamId

Number

팀 ID

memberId

Number

유저 ID

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 90

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : "삭제 완료"
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

String

삭제 완료 메시지

Chat API

채팅방 상세 조회

HTTP Request

GET /api/chat/enter?chatRoomId=1&memberId=2 HTTP/1.1
Content-Type: application/json
Host: localhost:8080
Parameter Description

chatRoomId

채팅방 ID

memberId

유저 ID

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 704

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "chatRoomId" : 1,
    "members" : [ {
      "memberId" : 0,
      "memberNickname" : "구성원 닉네임"
    }, {
      "memberId" : 0,
      "memberNickname" : "구성원 닉네임"
    } ],
    "messages" : [ {
      "chatMessageId" : 1,
      "memberNickname" : "메시지 보낸 유저 닉네임",
      "message" : "메시지 내용",
      "createdAt" : [ 2024, 4, 5, 10, 8, 56, 904684700 ]
    }, {
      "chatMessageId" : 1,
      "memberNickname" : "메시지 보낸 유저 닉네임",
      "message" : "메시지 내용",
      "createdAt" : [ 2024, 4, 5, 10, 8, 56, 904684700 ]
    } ]
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.chatRoomId

Number

채팅방 ID

data.members

Array

채팅방 구성원

data.members[].memberId

Number

구성원 ID

data.members[].memberNickname

String

구성원 닉네임

data.messages

Array

채팅방 메시지

data.messages[].chatMessageId

Number

해당 메시지 ID

data.messages[].memberNickname

String

채팅 보낸 유저 닉네임

data.messages[].message

String

메시지 내용

data.messages[].createdAt

Array

메시지 보낸 시간

Member API

회원가입

HTTP Request

POST /api/member/signup HTTP/1.1
Content-Type: application/json
Content-Length: 169
Host: localhost:8080

{
  "memberEmail" : "Jake95@naver.com",
  "memberPassword" : "qwer1234",
  "memberName" : "Jake",
  "memberNickname" : "J크",
  "memberBirthDate" : "1999-04-10"
}

Request Fields

Path Type Optional Description

memberEmail

String

이메일

memberNickname

String

닉네임

memberPassword

String

비밀번호

memberBirthDate

String

생년월일

memberName

String

이름

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 79

{
  "code" : 200,
  "status" : "OK",
  "message" : "회원 가입 성공"
}

Response Fields

Path Type Optional Description

code

Number

응답 코드

status

String

응답 상태

message

String

메시지

로그인

HTTP Request

POST /api/member/login HTTP/1.1
Content-Type: application/json
Content-Length: 76
Host: localhost:8080

{
  "memberEmail" : "Dong96@naver.com",
  "memberPassword" : "qwer1234"
}

Request Fields

Path Type Optional Description

memberEmail

String

이메일

memberPassword

String

비밀번호

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 222

{
  "code" : 200,
  "status" : "OK",
  "message" : "로그인에 성공하셨습니다.",
  "data" : {
    "memberId" : 1,
    "memberNickname" : "동동카",
    "memberToken" : "somekindoftokenblahblahlol"
  }
}

Response Fields

Path Type Optional Description

code

Number

응답 코드

status

String

응답 상태

message

String

메시지

data

Object

응답 데이터

data.memberId

Number

사용자 Index

data.memberNickname

String

사용자 닉네임

data.memberToken

String

사용자 토큰

회원 닉네임 수정

HTTP Request

PATCH /api/member/nickname HTTP/1.1
Content-Type: application/json
Content-Length: 57
Host: localhost:8080

{
  "memberId" : 1,
  "memberNickname" : "옹옹씌"
}

Request Fields

Path Type Optional Description

memberId

Number

사용자 Index

memberNickname

String

수정할 닉네임

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 126

{
  "code" : 200,
  "status" : "OK",
  "message" : "닉네임 변경에 성공하셨습니다.",
  "data" : "옹옹씌"
}

Response Fields

Path Type Optional Description

code

Number

응답 코드

status

String

응답 상태

message

String

메시지

data

String

응답 데이터

회원 비밀번호 수정

HTTP Request

PATCH /api/member/password HTTP/1.1
Content-Type: application/json
Content-Length: 102
Host: localhost:8080

{
  "memberId" : 1,
  "memberOriginPassword" : "gorila97",
  "memberChangePassword" : "97gorila"
}

Request Fields

Path Type Optional Description

memberId

Number

사용자 Index

memberOriginPassword

String

사용자 비밀번호

memberChangePassword

String

수정할 비밀번호

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 120

{
  "code" : 200,
  "status" : "OK",
  "message" : "비밀번호 변경에 성공하셨습니다.",
  "data" : ""
}

Response Fields

Path Type Optional Description

code

Number

응답 코드

status

String

응답 상태

message

String

메시지

data

String

응답 데이터

출석 인증

HTTP Request

POST /api/member/attend HTTP/1.1
Content-Type: application/json
Content-Length: 54
Host: localhost:8080

{
  "memberId" : 1,
  "memberDate" : "2024-04-05"
}

Request Fields

Path Type Optional Description

memberId

Number

사용자 Index

memberDate

String

현재 날짜

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 114

{
  "code" : 200,
  "status" : "OK",
  "message" : "출석 인증에 성공하셨습니다.",
  "data" : ""
}

Response Fields

Path Type Optional Description

code

Number

응답 코드

status

String

응답 상태

message

String

메시지

data

String

응답 데이터

사용자 출석 여부

HTTP Request

GET /api/member/attend/state?memberId=1 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 127

{
  "code" : 200,
  "status" : "OK",
  "message" : "금일 출석을 진행하지 않으셨습니다.",
  "data" : false
}

Response Fields

Path Type Optional Description

code

Number

응답 코드

status

String

응답 상태

message

String

메시지

data

Boolean

응답 데이터

Stock API

주식 리스트 가져오기

HTTP Request

GET /api/stock/list?page=0&size=5&stckIssuCmpyNm=&startPrice=0.0&endPrice=0.0 HTTP/1.1
Content-Type: application/json
Host: localhost:8080
Parameter Description

page

페이지 넘버 요청

size

페이지 크기 요청

stckIssuCmpyNm

검색 주식 이름

startPrice

검색 시작 가격

endPrice

검색 종료 가격

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1709

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "content" : [ {
      "stockId" : 2306,
      "crno" : "1801110004894",
      "isinCd" : "KR7004110003",
      "stckIssuCmpyNm" : "대선주조",
      "basDt" : [ 2024, 3, 28 ],
      "stckGenrDvdnAmt" : 939673.0
    }, {
      "stockId" : 2091,
      "crno" : "1101110216451",
      "isinCd" : "KR7309860005",
      "stckIssuCmpyNm" : "효성투자개발",
      "basDt" : [ 2024, 3, 28 ],
      "stckGenrDvdnAmt" : 220000.0
    }, {
      "stockId" : 715,
      "crno" : "1615110021158",
      "isinCd" : "KR7038990008",
      "stckIssuCmpyNm" : "넥스콘테크놀러지",
      "basDt" : [ 2024, 3, 28 ],
      "stckGenrDvdnAmt" : 139000.0
    }, {
      "stockId" : 1842,
      "crno" : "1101114884155",
      "isinCd" : "KR715782K024",
      "stckIssuCmpyNm" : "네파",
      "basDt" : [ 2024, 3, 28 ],
      "stckGenrDvdnAmt" : 54810.0
    }, {
      "stockId" : 2096,
      "crno" : "2101110134751",
      "isinCd" : "KR7311790000",
      "stckIssuCmpyNm" : "모스터일렉",
      "basDt" : [ 2024, 3, 28 ],
      "stckGenrDvdnAmt" : 39200.0
    } ],
    "pageable" : {
      "pageNumber" : 0,
      "pageSize" : 5,
      "sort" : {
        "empty" : true,
        "sorted" : false,
        "unsorted" : true
      },
      "offset" : 0,
      "unpaged" : false,
      "paged" : true
    },
    "last" : true,
    "totalPages" : 1,
    "totalElements" : 5,
    "size" : 5,
    "number" : 0,
    "sort" : {
      "empty" : true,
      "sorted" : false,
      "unsorted" : true
    },
    "first" : true,
    "numberOfElements" : 5,
    "empty" : false
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.content

Array

응답 데이터 배열

data.content[].stockId

Number

응답 데이터 주식 ID

data.content[].crno

String

응답 데이터 주식 CRNO

data.content[].isinCd

String

응답 데이터 주식 ISIN

data.content[].stckIssuCmpyNm

String

응답 데이터 주식 발행 회사 명

data.content[].basDt

Array

응답 데이터 주식 배당금 지급 날짜

data.content[].stckGenrDvdnAmt

Number

응답 데이터 주식 배당금 금액

data.pageable

Object

응답 데이터 페이지 정보

data.pageable.pageNumber

Number

응답 데이터 페이지 현재 페이지 넘버

data.pageable.pageSize

Number

응답 데이터 페이지 현재 페이지 크기

data.pageable.sort

Object

응답 데이터 페이지 현재 페이지 정렬

data.pageable.sort.empty

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.unsorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.sorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.offset

Number

응답 데이터 페이지 offset

data.pageable.paged

Boolean

응답 데이터 페이지 paged

data.pageable.unpaged

Boolean

응답 데이터 페이지 unpaged

data.last

Boolean

응답 데이터 마지막 페이지 여부

data.totalElements

Number

응답 데이터 총 숫자

data.totalPages

Number

응답 데이터 총 페이지

data.first

Boolean

응답 데이터 첫페이지 여부

data.numberOfElements

Number

응답 데이터 크기

data.size

Number

응답 데이터 크기

data.number

Number

응답 데이터 페이지 넘버

data.sort

Object

응답 데이터 정렬

data.sort.empty

Boolean

응답 데이터 정렬 empty

data.sort.unsorted

Boolean

응답 데이터 정렬 unsorted

data.sort.sorted

Boolean

응답 데이터 정렬 sorted

data.empty

Boolean

응답 데이터 empty

주식 배당금 금액 가져오기

HTTP Request

GET /api/stock/1 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 402

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "stockId" : 1,
    "crno" : "1101110012809",
    "isinCd" : "KR7000010009",
    "stckIssuCmpyNm" : "신한은행",
    "stockWithTransactionListDtoList" : [ {
      "basDt" : [ 2024, 4, 29 ],
      "stckGenrDvdnAmt" : 227.04
    }, {
      "basDt" : [ 2024, 5, 1 ],
      "stckGenrDvdnAmt" : 227.6
    } ]
  }
}

Response Fields

Path Type Optional Description

code

Number

코드

status

String

상태

message

String

메시지

data

Object

응답 데이터

data.stockId

Number

응답 데이터 주식 아이디

data.crno

String

응답 데이터 주식 CRNO

data.isinCd

String

응답 데이터 주식 ISINCD

data.stckIssuCmpyNm

String

응답 데이터 주식 이름

data.stockWithTransactionListDtoList

Array

응답 데이터 주식 배당금 리스트

data.stockWithTransactionListDtoList[].basDt

Array

응답 데이터 주식 배당금 날짜

data.stockWithTransactionListDtoList[].stckGenrDvdnAmt

Number

응답 데이터 주식 배당금 금액

Card API

카드 전체 조회

HTTP Request

GET /api/card?page=0&size=4&cardName=%EC%8B%A0%ED%95%9C&cardCompany=&startCardRequired=&endCardRequired=&startCardDomestic=&endCardDomestic= HTTP/1.1
Content-Type: application/json
Host: localhost:8080
Parameter Description

page

페이지 넘버 요청

size

페이지 크기 요청

cardName

검색 카드 이름

cardCompany

검색 카드 회사

startCardRequired

검색 카드 전월 실적 시작 금액

endCardRequired

검색 카드 전월 실적 종료 금액

startCardDomestic

검색 카드 연회비 시작 금액

endCardDomestic

검색 카드 연회비 종료 금액

HTTP Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1794

{
  "code" : 200,
  "status" : "OK",
  "message" : "OK",
  "data" : {
    "content" : [ {
      "cardId" : 1,
      "cardType" : "신용",
      "cardCompany" : "신한카드",
      "cardName" : "신한카드 Mr.Life",
      "cardBenefitType" : "할인형",
      "cardImg" : "https://api.card-gorilla.com:8080/storage/card/13/card_img/28201/13card.png",
      "cardTopCategory" : "공과금, 마트/편의점, 푸드",
      "cardCategory" : "공과금/렌탈, 교통, 기타, 마트/편의점, 병원/약국, 쇼핑, 주유, 통신, 푸드",
      "cardRequired" : 300000,
      "cardDomestic" : 0,
      "cardAbroad" : 15000
    }, {
      "cardId" : 2,
      "cardType" : "신용",
      "cardCompany" : "KB국민카드",
      "cardName" : "KB국민 My WE:SH 카드",
      "cardBenefitType" : "할인형",
      "cardImg" : "https://api.card-gorilla.com:8080/storage/card/2441/card_img/28283/2441card.png",
      "cardTopCategory" : "간편결제, 푸드, 선택형",
      "cardCategory" : "간편결제, 교통, 기타, 레저/스포츠, 마트/편의점, 뷰티/피트니스, 영화/문화, 카페/디저트, 통신, 푸드",
      "cardRequired" : 400000,
      "cardDomestic" : 15000,
      "cardAbroad" : 15000
    } ],
    "pageable" : {
      "pageNumber" : 0,
      "pageSize" : 4,
      "sort" : {
        "empty" : true,
        "sorted" : false,
        "unsorted" : true
      },
      "offset" : 0,
      "unpaged" : false,
      "paged" : true
    },
    "last" : true,
    "totalPages" : 1,
    "totalElements" : 2,
    "size" : 4,
    "number" : 0,
    "sort" : {
      "empty" : true,
      "sorted" : false,
      "unsorted" : true
    },
    "first" : true,
    "numberOfElements" : 2,
    "empty" : false
  }
}

Response Fields

Path Type Optional Description

code

Number

응답 코드

status

String

응답 상태

message

String

메시지

data

Object

응답 데이터

data.content

Array

응답 데이터 배열

data.content[].cardId

Number

카드 Id

data.content[].cardType

String

체크카드/신용카드 여부

data.content[].cardCompany

String

카드 회사명

data.content[].cardName

String

카드명

data.content[].cardBenefitType

String

카드 보상 타입

data.content[].cardImg

String

카드 이미지 url

data.content[].cardTopCategory

String

카드 혜택 top3

data.content[].cardCategory

String

카드 혜택

data.content[].cardRequired

Number

전월 실적

data.content[].cardDomestic

Number

국내 연회비

data.content[].cardAbroad

Number

해외 연회비

data.pageable

Object

응답 데이터 페이지 정보

data.pageable.pageNumber

Number

응답 데이터 페이지 현재 페이지 넘버

data.pageable.pageSize

Number

응답 데이터 페이지 현재 페이지 크기

data.pageable.sort

Object

응답 데이터 페이지 현재 페이지 정렬

data.pageable.sort.empty

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.unsorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.sort.sorted

Boolean

응답 데이터 페이지 현재 페이지 정렬 데이터

data.pageable.offset

Number

응답 데이터 페이지 offset

data.pageable.paged

Boolean

응답 데이터 페이지 paged

data.pageable.unpaged

Boolean

응답 데이터 페이지 unpaged

data.last

Boolean

응답 데이터 마지막 페이지 여부

data.totalElements

Number

응답 데이터 총 숫자

data.totalPages

Number

응답 데이터 총 페이지

data.first

Boolean

응답 데이터 첫페이지 여부

data.numberOfElements

Number

응답 데이터 크기

data.size

Number

응답 데이터 크기

data.number

Number

응답 데이터 페이지 넘버

data.sort

Object

응답 데이터 정렬

data.sort.empty

Boolean

응답 데이터 정렬 empty

data.sort.unsorted

Boolean

응답 데이터 정렬 unsorted

data.sort.sorted

Boolean

응답 데이터 정렬 sorted

data.empty

Boolean

응답 데이터 empty