Partners API
상대방(파트너) 사주 정보 관리 엔드포인트입니다.
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
| POST | /api/partners | 파트너 등록 | 필요 |
| GET | /api/partners | 내 파트너 목록 조회 | 필요 |
| GET | /api/partners/{partnerId} | 파트너 단건 조회 | 필요 |
| PATCH | /api/partners/{partnerId} | 파트너 정보 수정 | 필요 |
| DELETE | /api/partners/{partnerId} | 파트너 삭제 | 필요 |
POST /api/partners
파트너의 사주 입력 정보를 저장합니다. 최대 4명까지 등록 가능하며, 초과 시 400을 반환합니다.
에러:
| 상황 | HTTP |
|---|---|
| 4명 초과 등록 시도 | 400 |
GET /api/partners
로그인 사용자가 등록한 파트너 전체 목록을 반환합니다.
GET /api/partners/{partnerId}
파트너 단건 조회입니다.
| 파라미터 | 위치 | 설명 |
|---|---|---|
partnerId | path | 파트너 ID |
에러:
| 상황 | HTTP | 에러 코드 |
|---|---|---|
| 파트너 없음 | 404 | PARTNER_NOT_FOUND |
PATCH /api/partners/{partnerId}
파트너 이름·생년월일·성별 등을 수정합니다. 수정 시 기존 궁합 캐시는 삭제되어 다음 궁합 조회 시 재계산됩니다.
DELETE /api/partners/{partnerId}
파트너를 삭제합니다.
Response: 204 No Content