레거시 시스템에서 API를 정리하는 방법

1. 요즘 일하는 방식이 조금 바뀌었다

요즘 내가 하는 일은 크게 보면 예전과 같다.

여전히 레거시 기반 시스템을 유지하면서 기능을 만들고 있다.

다만 달라진 건 하나다.

이제는 “기능 구현”보다 “구조 정리”에 더 시간을 쓴다

특히 API를 만드는 방식이 많이 바뀌었다.

2. 레거시 위에서 정리하는 작업

이 환경은 새로 만드는 구조가 아니라

이미 쌓여 있는 것 위에서 작업하는 구조다.

그래서 요즘은 새로운 걸 만들기보다

기존을 정리하는 작업을 계속 반복하고 있다.

• 응답 구조를 맞추고
• 파라미터 규칙을 정리하고
• 최소한의 일관성을 만든다

예를 들어, 모든 API는 아래와 같은 형태를 기본으로 맞추고 있다.

{
  "success":true,
  "message":"OK",
  "data": {}
}

단순하지만,

이 정도만 통일해도 프론트에서 처리하는 방식이 훨씬 단순해진다.

3. API를 만들 때 같이 하는 것들

요즘은 API 하나를 만들 때

자연스럽게 같이 따라오는 작업들이 있다.

• 요청/응답 구조를 먼저 정리하고
• 문서 형태로 남기고
• 바로 실행해서 확인한다

예전에는 이게 다 따로였다.

• 코드 따로
• 문서 따로
• 테스트 따로

지금은 이걸 하나의 흐름으로 묶었다.

만들고 → 확인하고 → 바로 테스트한다

이 흐름이 끊기지 않게 만드는 게 핵심이다.

4. 구현 방식도 조금씩 바뀌고 있다

구현 자체는 여전히 레거시 방식이지만,

기준은 조금씩 정리하고 있다.

예를 들면

• 입력값 검증은 초반에 처리하고
• 실패/성공 응답은 명확히 분리하고
• 결과는 항상 같은 구조로 반환한다

코드 자체를 크게 바꾸진 못하지만,

“패턴”은 맞추고 있다.

이게 쌓이기 시작하면

나중에 훨씬 다루기 쉬워진다.

5. 프론트도 같이 맞춘다

프론트도 별도로 크게 바꾸진 않는다.

다만 API 규칙이 정리되면서

프론트 코드도 자연스럽게 단순해졌다.

• 성공/실패 분기가 명확해지고
• 공통 처리 코드가 줄어들고
• 예외 케이스가 줄어든다

결국 API 하나 잘 정리하는 게

프론트까지 영향을 준다.

6. 혼자 개발하면서 생긴 변화

지금은 프론트도 혼자 보고 있다.

그래서 구조를 잡는 기준이 조금 달라졌다.

예전에는

• 역할 분리
• Mock API
• 병렬 개발

이런 걸 고려했다면,

지금은

“내가 빠르게 확인할 수 있는 구조인가”

이걸 더 중요하게 본다.

그래서 중간 단계를 줄이고

하나의 흐름으로 바로 연결하는 방식으로 바뀌었다.

7. 문서가 따로 놀지 않게

예전에는 문서가 따로 있었다.

지금은 다르게 보고 있다.

• 문서가 코드와 연결되어 있고
• 수정하면 같이 반영되고
• 다시 확인할 수 있어야 한다

그래야 의미가 있다.

문서가 “설명”이 아니라

“같이 움직이는 구조”가 되는 느낌이다.

8. 레거시 환경에서의 선택

이 환경에서는 선택지가 많지 않다.

그래서 지금은

• 완전히 새로 만들기보다
• 기존 위에 얹고
• 조금씩 정리하는 방식

으로 가고 있다.

이게 느려 보일 수 있지만

실제로는 가장 안정적인 방법이다.

9. 마무리

요즘 느끼는 건 단순하다.

좋은 구조는 한 번에 만들어지지 않는다

조금씩 맞추고,

조금씩 줄이고,

조금씩 정리하는 과정이다.

눈에 띄는 변화는 아니지만

확실히 개발은 덜 복잡해지고 있다.