Swagger.yml (7/15 이후)

API 명세서(공통 URL : /api)

public class ApiResponse<T> {

    private final String code;
    private final HttpStatus status;
    private final String message;
    private final T data;
    private final LocalDateTime timestamp;

    private ApiResponse(BaseCode baseCode, T data) {
        this.code = baseCode.getCode();
        this.status = baseCode.getStatus();
        this.message = baseCode.getMessage();
        this.data = data;
        this.timestamp = LocalDateTime.now();
    }

    /**
     * 주어진 BaseCode와 데이터를 사용해 ApiResponse를 생성합니다.
     *
     * @param code 상태 코드, HTTP 상태, 메시지를 담은 BaseCode
     * @param data 응답 페이로드 (없으면 {@code null})
     * @param <T>  페이로드 타입
     * @return ApiResponse 인스턴스
     */
    public static <T> ApiResponse<T> of(BaseCode code, T data) {
        return new ApiResponse<>(code, data);
    }

    /**
     * 주어진 BaseCode를 사용해 데이터 없이 성공 응답을 생성합니다.
     *
     * @param code 상태 코드, HTTP 상태, 메시지를 담은 BaseCode
     * @param <T> 페이로드 타입
     * @return ApiResponse 인스턴스
     */
    public static <T> ApiResponse<T> ok(BaseCode code) {
        return new ApiResponse<>(code, null);
    }
}

Swagger.yml

<aside> 📋

사용자

</aside>

swagger.yml

<aside> 📋

관리자

</aside>

swagger_admin.yml

7/8일- 10:26 수정본

swagger.yml

7/8일- 14:35 수정본-지도에서 혜택 상세보기 추가