순시미 플랫폼의 REST API 문서입니다. 보호자(Guardian), 케어대상자(Ward), 케어매니저(Staff)를 연결하는 케어 매니지먼트 플랫폼의 백엔드 API를 제공합니다.
Base URL: 환경별 설정
- Local:
http://localhost:8080
- Dev:
https://dev-api.soonseeme.com
- Production:
https://api.soonseeme.com
인증 (Authentication)
대부분의 API는 JWT Bearer 토큰 인증이 필요합니다.
Authorization: Bearer {JWT_TOKEN}
인증 불필요 (Public) 엔드포인트
| 카테고리 | 엔드포인트 |
|---|
| 회원가입 | /v1/guardian/sign-up, /v1/staff/sign-up, /v2/ward/sign-up |
| 로그인 | /v1/login, /v1/auto-login |
| OAuth | /v1/kakao/login, /v1/kakao/callback/* |
| 본인인증 | /v1/danal/* |
| 공통 | /v1/enum, /health |
토큰 획득 플로우
- ID/PW 로그인:
POST /v1/login → JWT 토큰 반환 (HttpOnly Cookie)
- OAuth 로그인:
GET /v1/kakao/login → 카카오 인증 → JWT 토큰 반환
- 자동 로그인:
POST /v1/auto-login → Device ID 기반 토큰 갱신
응답 형식
성공 응답
{
"responseCode": "0000",
"responseMessage": "성공",
"result": { ... }
}
에러 응답
{
"code": "MEMBER_ERROR_0011",
"message": "주민등록번호를 확인해 주세요."
}
도메인 구조
| 도메인 | 설명 | 주요 역할 |
|---|
| 보호자 (Guardian) | 케어 서비스를 신청하는 가족 | 회원가입, 케어대상자 등록, 매칭 신청 |
| 케어대상자 (Ward) | 케어를 받는 어르신/수급자 | 프로필 관리, 일정 조회 |
| 직원/케어매니저 (Staff) | 케어 서비스를 제공하는 요양보호사 | 매칭 수락, 돌봄일지 작성, 일정 관리 |
| 매칭 (Matching) | 보호자-케어매니저 연결 | 매칭 요청/수락/거절, 계약 관리 |
| 모니터링 (Monitoring) | 케어 활동 기록 | 돌봄일지, 투약일지, 추가요금 |
| 커뮤니티 (Community) | 사용자 소통 공간 | 게시글, 댓글, 좋아요, 북마크 |
좌측 사이드바에서 태그별로 그룹핑된 API 엔드포인트를 확인할 수 있습니다.
각 엔드포인트를 클릭하면 Request/Response 스키마와 테스트 기능을 사용할 수 있습니다.
