🔐 OAuth 로그인 연동 API 명세

구분	Method	Endpoint	설명	요청 바디 예시	응답 예시
카카오 로그인 요청	GET	`/oauth2/authorization/kakao`	사용자 로그인 요청	-	-
카카오 로그인 토큰 발급	GET	`/oauth2/authorization/kakao/callback`	인가 코드를 이용해 카카오 토큰 발급	카카오에서 발급한 인가코드 쿼리 파라미터	`json { "accesstoken" : "~~~~", "refreshtoken": "~~~", "nickname": "홍길동" }`
회원 정보 삭제	DELETE	`/oauth2/authorization/kakao/users/withdraw`	사용자 계정 삭제	Authentication에서 principle 가져와서 userId 뽑아서 사용	-
OIDC 유저 정보 조회	GET	`/oauth2/authorization/kakao/userinfo`	Access Token을 이용해 사용자 정보 요청	Header: `Authorization: Bearer {access_token}`	`json { "nickname": "홍길동" }`

🧍 비회원 User API 명세

구분	Method	Endpoint	설명	요청 바디 예시	응답 예시

📋 Interview Question Set API 명세

API 명세 (보기 쉬운 ver)

구분	Method	Endpoint	설명	요청 바디 예시	응답 예시
질문 세트 생성	POST	`/api/question-sets`	면접 질문 세트 생성	`json { "title": "면접 질문 세트 제목", "description": "면접 질문 세트 설명.", "versionNumber": 1,
"parentVersionId": 1,
"isShared": false, "tags": ["백엔드"], "questionMaps": [ { "id": 5 }, { "id": 6 } ] }`	`json { "id": 11, "ownerUserId": 1, "title": "면접 질문 세트 제목", "description": "면접 질문 세트입 설명.", "versionNumber": 1, "parentVersionId": 1, "isShared": false, "tags":[ { "id": 1, "tag": "백엔드" } ], "questionMaps": [ { "id": 5, "content": "질문 내용", "questionType": 2, "expectedAnswer": "예상 답변", "answers": [ {"id": 7, "content": "답변"} ] } ], "createdAt": "2025-01-01T01:00:00Z", "updatedAt": "2025-01-01T01:00:00Z" }`
질문 세트 목록 조회	GET	`/api/question-sets`	모든 면접 질문 세트 목록 조회		json [ { "id": 5, "ownerUserId": 5, "title": "수정된 제목", "description": "수정된 설명", "versionNumber": 2, "parentVersionId": 4, "isShared": false, "tags": [ { "id": 1, "tag":백엔드" } ], "questionMaps": [ { "id": 2, "questionId": 102, "displayOrder": 2 }, { "id": 3, "questionId": 103, "displayOrder": 3 } ], "createdAt": "2025-08-01T01:00:00Z", "updatedAt": "2025-08-05T03:00:00Z" }, { "id": 6, "ownerUserId": 6, "title": "수정된 제목2", "description": "수정된 설명2", "versionNumber": 2, "parentVersionId": 4, "isShared": false, "tags": [ { "id": 1, "tag":백엔드" } ], "questionMaps": [ { "id": 4, "questionId": 104, "displayOrder": 4 }, { "id": 5, "questionId": 105, "displayOrder": 5 } ], "createdAt": "2025-08-01T01:00:00Z", "updatedAt": "2025-08-05T03:00:00Z" } ]
질문 세트 조회	GET	`/api/question-sets/{id}`	면접 질문 세트 조회		`json { "id": 5, "ownerUserId": 5, "title": "수정된 제목", "description": "수정된 설명", "versionNumber": 2, "parentVersionId": 4, "isShared": false, "tags": [ { "id": 1, "tag":백엔드" } ], "questionMaps": [ { "id": 2, "questionId": 102, "displayOrder": 2 }, { "id": 3, "questionId": 103, "displayOrder": 3 } ], "createdAt": "2025-08-01T01:00:00Z", "updatedAt": "2025-08-05T03:00:00Z" }`
질문 세트 수정	PATCH	`/api/question-sets/{id}`	면접 질문 세트 수정	`json { "ownerUserId": 5, “title”: “수정될 제목”, “description”: “수정될 설명”, "tags": ["백엔드"], "questionMaps: [ { "questionId": 103, "displayOrder": 3 } ]", “versionNumber”: 2, “parentVersionId”: 4, “isShared”: false }`	`json { "id": 5, "ownerUserId": 5, "title": "수정된 제목", "description": "수정된 설명", "versionNumber": 2, "parentVersionId": 4, "isShared": false, "tags": [ { "id": 1, "tag":백엔드" } ], "questionMaps": [ { "id": 2, "questionId": 102, "displayOrder": 2 }, { "id": 3, "questionId": 103, "displayOrder": 3 } ], "createdAt": "2025-08-01T01:00:00Z", "updatedAt": "2025-08-05T03:00:00Z" }`
질문 세트 삭제	DELETE	`/api/question-sets/{id}`	면접 질문 세트 삭제		`json { "deletedAt": "2025-01-01T01:00:00Z", “message” : “질문 세트가 삭제됐습니다.” }`
질문 생성	POST	`/api/questions`	면접 질문 생성	`json { “content”: “새 질문 내용”, “questionType”: 2, “expectedAnswer”: “예상 답변” }`	`json { "id": 20, "content": "새 질문 내용", "questionType": 2, "expectedAnswer": "예상 답변", "answers": [], "createdAt": "2025-01-01T01:00:00Z", "updatedAt": "2025-01-02T01:00:00Z" }`
질문 목록 조회	GET	`/api/questions`	면접 질문 목록 조회		json [ { "id": 10, "content": "수정된 질문 내용", "questionType": 1, “expectedAnswer”: “수정된 예상 답변”, "answers": [ { "id": 5, "content": "답변 내용" } ], "createdAt": "2025-01-01T01:00:00Z", "updatedAt": "2025-01-02T01:00:00Z" }, { "id": 11, "content": "수정된 질문 내용2", "questionType": 1, “expectedAnswer”: “수정된 예상 답변2”, "answers": [ { "id": 6, "content": "답변 내용2" } ], "createdAt": "2025-01-01T01:00:00Z", "updatedAt": "2025-01-02T01:00:00Z" } ]
질문 조회	GET	`/api/questions/{id}`	면접 질문 조회		`json { "id": 10, "content": "수정된 질문 내용", "questionType": 1, “expectedAnswer”: “수정된 예상 답변”, "answers": [ { "id": 5, "content": "답변 내용" } ], "createdAt": "2025-01-01T01:00:00Z", "updatedAt": "2025-01-02T01:00:00Z" }`
질문 수정	PATCH	`/api/questions/{id}`	면접 질문 수정	`json { “content”: “수정할 질문 내용”, "questionType”: 1, “expectedAnswer”: “수정할 예상 답변”, "answers": [ { "id": 5 } ] }`	`json { "id": 10, "content": "수정된 질문 내용", "questionType": 1, “expectedAnswer”: “수정된 예상 답변”, "answers": [ { "id": 5, "content": "답변 내용" } ], "createdAt": "2025-01-01T01:00:00Z", "updatedAt": "2025-01-02T01:00:00Z" }`
질문 삭제	DELETE	`/api/questions/{id}`	면접 질문 삭제		`json { "deletedAt": "2025-01-01T01:00:00Z", “message” : “질문이 삭제됐습니다.” }`
답변 생성	POST	`/api/answers`	면접 답변 생성	`json { “content”: “새 답변 내용”, “question”: [ { "id": 5 } ] }`	`json { "id": 10, "content": "새 답변 내용", "question": [ { "id": 5, "content": "질문 내용", "questionType": 2, "expectedAnswer": "예상 답변" } ], "createdAt": "2025-01-01T01:00:00Z", "updateddAt": "2025-01-02T01:00:00Z" }`
답변 목록 조회	GET	`/api/answers`	면접 답변 목록 조회		`json [ { "id": 10, "content": "새 답변 내용", "question": [ { "id": 5, "content": "질문 내용", "questionType": 2, "expectedAnswer": "예상 답변" } ], "createdAt": "2025-01-01T01:00:00Z", "updateddAt": "2025-01-02T01:00:00Z" }, { "id": 11, "content": "새 답변 내용2", "question": [ { "id": 6, "content": "질문 내용2", "questionType": 2, "expectedAnswer": "예상 답변2" } ], "createdAt": "2025-01-01T01:00:00Z", "updateddAt": "2025-01-02T01:00:00Z" } ]`
답변 조회	GET	`/api/answers/{id}`	면접 답변 조회		`{ "id" : 10, "content" : "수정된 질문 내용", "questionType" : 1, “expectedAnswer” : “수정된 예상 답변”, "answers": [ { "id": 5, "content": "답변 내용" } ], "createdAt": "2025-01-01T01:00:00Z", "updatedAt": "2025-01-02T01:00:00Z" }`
답변 수정	PATCH	`/api/answers/{id}`	면접 답변 수정	`json { “content”: “수정할 답변 내용” }`	`json { "id": 10, "content" :"수정된 답변 내용", "question": [ { "id": 5, "content": "질문 내용", "questionType": 2, "expectedAnswer": "예상 답변" } ], "createdAt": "2025-01-01T01:00:00Z", "updateddAt": "2025-01-02T01:00:00Z" }`
답변 삭제	DELETE	`/api/answers/{id}`	면접 답변 삭제		`json { "deletedAt": "2025-01-01T01:00:00Z", “message” : “답변이 삭제됐습니다.” }`

보기 편하려고 복붙했어요

Kkori WebSocket API 명세서

개요

Kkori 면접 연습 플랫폼의 실시간 WebSocket API 명세서입니다. STOMP 프로토콜을 사용하여 실시간 면접 세션을 관리합니다.

연결 정보

WebSocket 엔드포인트: /ws
SockJS 지원: Yes
프로토콜: STOMP over WebSocket
인증: JWT 토큰 기반 (쿠키 또는 헤더)

메시지 경로

클라이언트 → 서버: /app/{endpoint}