> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soonseeme.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 순시미 API Reference

> 순시미(Soonseeme) 백엔드 API 문서 - 프론트엔드 연동 가이드

## 개요

순시미 플랫폼의 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 토큰 인증이 필요합니다.

```bash theme={null}
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`                                           |

### 토큰 획득 플로우

1. **ID/PW 로그인**: `POST /v1/login` → JWT 토큰 반환 (HttpOnly Cookie)
2. **OAuth 로그인**: `GET /v1/kakao/login` → 카카오 인증 → JWT 토큰 반환
3. **자동 로그인**: `POST /v1/auto-login` → Device ID 기반 토큰 갱신

## 응답 형식

### 성공 응답

```json theme={null}
{
  "responseCode": "0000",
  "responseMessage": "성공",
  "result": { ... }
}
```

### 에러 응답

```json theme={null}
{
  "code": "MEMBER_ERROR_0011",
  "message": "주민등록번호를 확인해 주세요."
}
```

## 도메인 구조

| 도메인               | 설명                 | 주요 역할                 |
| ----------------- | ------------------ | --------------------- |
| 보호자 (Guardian)    | 케어 서비스를 신청하는 가족    | 회원가입, 케어대상자 등록, 매칭 신청 |
| 케어대상자 (Ward)      | 케어를 받는 어르신/수급자     | 프로필 관리, 일정 조회         |
| 직원/케어매니저 (Staff)  | 케어 서비스를 제공하는 요양보호사 | 매칭 수락, 돌봄일지 작성, 일정 관리 |
| 매칭 (Matching)     | 보호자-케어매니저 연결       | 매칭 요청/수락/거절, 계약 관리    |
| 모니터링 (Monitoring) | 케어 활동 기록           | 돌봄일지, 투약일지, 추가요금      |
| 커뮤니티 (Community)  | 사용자 소통 공간          | 게시글, 댓글, 좋아요, 북마크     |

<Note>
  좌측 사이드바에서 태그별로 그룹핑된 API 엔드포인트를 확인할 수 있습니다.
  각 엔드포인트를 클릭하면 Request/Response 스키마와 테스트 기능을 사용할 수 있습니다.
</Note>