동국대학교 동아리 행정 ERP API
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"33657317","collectionId":"0d9956d7-c7d7-4295-992d-c873633888e1","publishedId":"2sB2cUAiAt","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-04-05T03:24:39.000Z"},"item":[{"name":"Account API","item":[{"name":"createAccount (계좌 생성)","id":"19a29aa1-2229-4aed-b3bf-1909daa226ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{vault:json-web-token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"number\": \"123456\",\n \"createdAt\": \"2025-04-03T20:47:28.632Z\",\n \"userId\": 2,\n \"clubId\": 1\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/account/protected","description":"새로운 Account 생성
\nHTTP Method: POST
\nURL: /account
Parameters:
\n_AccountCreateRequest_의 필드에 따라 작성)성공:
\nHTTP Status: 201 Created
\n{ \"account\": { \"field1\": \"value1\", \"field2\": \"value2\" }}
\n실패:
\nHTTP Status: 404 Not Found
\n{ \"error\": \"ClubNotFoundException or UserNotFoundException message\"}
\n동아리 ID를 통해 통장 정보와 거래 내역을 페이징 처리하여 조회
\nHTTP Method: GET
\nURL: /account/{clubId}
Parameters:
\nPathVariable:
clubId (Long) - 동아리 IDRequestParam:
page (int, optional, default: 0) - 조회할 페이지 번호
size (int, optional, default: 7) - 페이지당 데이터 개수
성공:
\nHTTP Status: 200 OK
\n{ \"number\": \"string\", \"createdAt\": \"2023-04-11T00:00:00Z\", \"ownerName\": \"string\", \"clubName\": \"string\", \"accountHistories\": [ { \"payType\": \"string\", \"content\": \"string\", \"usedAmount\": 1000, \"totalAmount\": 5000, \"createdAt\": \"2023-04-11T00:00:00Z\" } ], \"paginationInfo\": { \"currentPage\": 0, \"pageSize\": 7, \"totalPages\": 1, \"totalElements\": 10 }}
\n실패:
\nHTTP Status: 404 NOT FOUND
\n{ \"timestamp\": \"2023-04-11T00:00:00Z\", \"status\": 404, \"error\": \"Not Found\", \"message\": \"Club not found\" or \"Account not found\", \"path\": \"/account/{clubId}\"}
\n통장의 번호, 소유주, 동아리 정보 수정
\nHTTP Method: PUT
\nURL: /account/{accountId}
Parameters:
\nPath Variable:
\naccountId (Long) - 수정할 통장의 IDRequest Body:
\nnumber (String) - 통장 번호
userId (Long) - 소유주 ID
clubId (Long) - 동아리 ID
성공:
\nHTTP Status: 200 OK
\n{ \"number\": \"string\", \"createdAt\": \"2023-10-01T12:00:00Z\", \"updatedAt\": \"2023-10-01T12:00:00Z\", \"ownerName\": \"string\", \"clubName\": \"string\"}
\n실패:
\nHTTP Status: 404 Not Found
\n{ \"status\": 404, \"error\": \"Not Found\", \"message\": \"해당 통장이 존재하지 않습니다.\" // 또는 관련된 에러 메시지}
\n동아리별 통장 소프트 삭제 처리
\nHTTP Method: DELETE
\nURL: /account/{accountId}
Parameters:
\naccountId (Path Variable): 삭제할 통장의 ID성공:
\nHTTP Status: 200 OK
\n\"통장이 정상적으로 삭제되었습니다.\"
\n실패:
\nHTTP Status: 404 Not Found
\n{ \"timestamp\": \"yyyy-MM-dd'T'HH:mm:ss.SSSZ\", \"status\": 404, \"error\": \"Not Found\", \"message\": \"Account not found\", \"path\": \"/account/{accountId}\"}
\n통장 관리 API
\n","_postman_id":"45618377-e4fd-45cd-9b92-2da244153cf3"},{"name":"User API","item":[{"name":"me","id":"f275ba44-516a-4890-94b2-0dd8e9de8c85","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8081/users/me","description":"인증/인가 관련 API
\n","_postman_id":"a92a8f7e-0a02-4174-912d-5a391fb5b2b1"},{"name":"BudgetPlan API","item":[{"name":"create","id":"a0f129e9-ab4a-410f-8e12-782b6bb10ec8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"executeType\": \"생성\",\r\n \"clubName\":\"디벨로퍼\",\r\n \"paymentType\": \"CARD\",\r\n \"expectedPaymentDate\": \"2025-03-30T15:17:56\",\r\n \"content\": \"사무용품 월간 예산\",\r\n \"drafterId\": 1,\r\n \"paymentAmount\": 1500,\r\n \"planReviewerId\": 2,\r\n \"planApproverId\": 3\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/budget/plan","urlObject":{"protocol":"http","port":"8081","path":["budget","plan"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"a0f129e9-ab4a-410f-8e12-782b6bb10ec8"},{"name":"update","id":"ffd2c600-194c-4691-98d3-177133ffecda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"executeType\": \"생성\",\r\n \"paymentType\": \"CARD\",\r\n \"expectedPaymentDate\": \"2025-03-30T15:17:56\",\r\n \"content\": \"사무용품 월간 예산\",\r\n \"drafterId\": 1,\r\n \"paymentAmount\": 1500,\r\n \"planReviewerId\": 2,\r\n \"planApproverId\": 3\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/budget/plan/1","urlObject":{"protocol":"http","port":"8081","path":["budget","plan","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"ffd2c600-194c-4691-98d3-177133ffecda"},{"name":"approveReview","id":"6c320443-5d2a-4ea9-a349-cc2aaf86c733","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"url":"http://localhost:8081/budget/plan/1/review/approve?reviewer=김영희","urlObject":{"protocol":"http","port":"8081","path":["budget","plan","1","review","approve"],"host":["localhost"],"query":[{"key":"reviewer","value":"김영희"}],"variable":[]}},"response":[],"_postman_id":"6c320443-5d2a-4ea9-a349-cc2aaf86c733"},{"name":"approveFinal","id":"41e030e2-8e27-4c55-8051-eef08cbadd48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"PATCH","header":[],"url":"http://localhost:8081/budget/plan/1/final/approve?approverId=3","urlObject":{"protocol":"http","port":"8081","path":["budget","plan","1","final","approve"],"host":["localhost"],"query":[{"key":"approverId","value":"3"}],"variable":[]}},"response":[],"_postman_id":"41e030e2-8e27-4c55-8051-eef08cbadd48"},{"name":"reject","id":"94c47202-3fc9-485b-83ed-bdaed8511bc1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\r\n \"reviewerId\": 2\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/budget/plan/2/reject","urlObject":{"protocol":"http","port":"8081","path":["budget","plan","2","reject"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"94c47202-3fc9-485b-83ed-bdaed8511bc1"},{"name":"getBudgetPlanById","id":"d29c6abf-1d42-4270-9ef7-e0f869ace00e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8081/budget/plan/1","urlObject":{"protocol":"http","port":"8081","path":["budget","plan","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"d29c6abf-1d42-4270-9ef7-e0f869ace00e"},{"name":"getFilteredBudgetPlans","id":"6af81ace-1393-4ecf-889c-777e2557bf05","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"executeType\": \"생성\",\r\n \"clubName\":\"디벨로퍼\",\r\n \"paymentType\": \"CARD\",\r\n \"expectedPaymentDate\": \"2025-03-30T15:17:56\",\r\n \"content\": \"사무용품 월간 예산\",\r\n \"author\": \"홍길동\",\r\n \"paymentAmount\": 1500,\r\n \"planReviewer\": \"김영희\",\r\n \"planApprover\": \"이철수\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"http://localhost:8081/budget/plan","urlObject":{"protocol":"http","port":"8081","path":["budget","plan"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"6af81ace-1393-4ecf-889c-777e2557bf05"}],"id":"d91358ee-6ffe-4444-9e11-062158e5b991","_postman_id":"d91358ee-6ffe-4444-9e11-062158e5b991","description":""}]}