[Feature] 점검 안내 API 구현 #92

Closed
opened 2026-02-10 05:32:35 +00:00 by seonkyu.kim · 0 comments
Owner

설명

SPMS 플랫폼 점검 상태를 조회하는 Public API를 구현한다.
AppConfig 테이블의 maintenance_mode, maintenance_message, maintenance_end_time 키를 활용하여 현재 점검 상태를 반환한다.

API 명세

  • API ID: API_SPMS_01_PUBLIC_10
  • URI: POST /v1/in/public/maintenance
  • 보안 등급: 1단계 (공개)
  • X-Service-Code: 불필요 (SPMS 공용 API)

응답

{
    "result": true,
    "code": "000",
    "msg": "",
    "data": {
        "is_maintenance": true,
        "maintenance_msg": "서비스 점검 중입니다.",
        "estimated_end_time": "2025-02-07T06:00:00"
    }
}

체크리스트

  • MaintenanceResponseDto.cs — 응답 DTO
  • IAppConfigService.cs — GetMaintenanceAsync 메서드 추가
  • AppConfigService.cs — 점검 상태 조회 로직 구현
  • MaintenanceController.cs — POST /v1/in/public/maintenance
  • 빌드 성공 확인
## 설명 SPMS 플랫폼 점검 상태를 조회하는 Public API를 구현한다. AppConfig 테이블의 `maintenance_mode`, `maintenance_message`, `maintenance_end_time` 키를 활용하여 현재 점검 상태를 반환한다. ## API 명세 - **API ID**: API_SPMS_01_PUBLIC_10 - **URI**: `POST /v1/in/public/maintenance` - **보안 등급**: 1단계 (공개) - **X-Service-Code**: 불필요 (SPMS 공용 API) ## 응답 ```json { "result": true, "code": "000", "msg": "", "data": { "is_maintenance": true, "maintenance_msg": "서비스 점검 중입니다.", "estimated_end_time": "2025-02-07T06:00:00" } } ``` ## 체크리스트 - [x] `MaintenanceResponseDto.cs` — 응답 DTO - [x] `IAppConfigService.cs` — GetMaintenanceAsync 메서드 추가 - [x] `AppConfigService.cs` — 점검 상태 조회 로직 구현 - [x] `MaintenanceController.cs` — POST /v1/in/public/maintenance - [x] 빌드 성공 확인
seonkyu.kim added the
Priority
Low
Status
In Progress
Type
Feature
labels 2026-02-10 05:32:43 +00:00
seonkyu.kim self-assigned this 2026-02-10 05:32:47 +00:00
seonkyu.kim added this to the Phase 2-2: Public & 디바이스 & 파일 API milestone 2026-02-10 05:32:49 +00:00
seonkyu.kim added
Status
Done
and removed
Status
In Progress
labels 2026-02-10 05:37:09 +00:00
Sign in to join this conversation.
No description provided.