API 개발을 위한 모의 데이터 생성: 완벽 가이드

2026년 3월 31일 · 12분 읽기

현대 개발에서 모의 데이터가 중요한 이유

모의 데이터는 프론트엔드와 백엔드 프로세스를 분리하여 병렬 개발 워크플로우를 가능하게 하기 때문에 현대 웹 개발의 기본입니다. 이러한 분리를 통해 프론트엔드 엔지니어는 백엔드 API 준비와 독립적으로 UI 컴포넌트를 개발하고 테스트할 수 있어 프로젝트 일정을 극적으로 단축시킵니다.

백엔드 API가 아직 개발 중이거나 사용할 수 없을 때, 모의 데이터는 실제 API 응답을 모방하는 신뢰할 수 있는 대체물 역할을 합니다. 이 접근 방식을 통해 개발자는 통제된 방식으로 다양한 데이터 시나리오를 시뮬레이션하고, 엣지 케이스를 테스트하며, 백엔드 완성을 기다리지 않고 UI 동작을 검증할 수 있습니다.

개발 속도 외에도, 모의 데이터는 개발 주기 초기에 잠재적인 UI 버그를 식별하는 데 도움이 됩니다. 엣지 케이스, 빈 상태, 오류 조건을 포함한 다양한 데이터셋으로 테스트함으로써 팀은 디버깅 작업량을 최소화하고 프로젝트 수명 주기 후반에 발생하는 비용이 많이 드는 조정을 줄일 수 있습니다.

모의 데이터의 비즈니스 가치

강력한 모의 데이터 전략을 구현하는 조직은 상당한 이점을 보고합니다:

• 개발 시간 단축: 프론트엔드와 백엔드 팀이 차단 종속성 없이 병렬로 작업
• 비용 절감: 초기에 발견된 버그는 프로덕션에서 발견된 버그보다 수정 비용이 기하급수적으로 저렴
• 테스트 커버리지 향상: 실제 데이터로 재현하기 어렵거나 비용이 많이 드는 시나리오 테스트 가능
• 협업 개선: 모의 데이터를 통해 정의된 명확한 API 계약으로 팀 간 커뮤니케이션 향상
• 보안 강화: 개발 및 테스트 환경에서 민감한 프로덕션 데이터 노출 방지

모의 데이터 생성 접근 방식

프로젝트마다 다른 모킹 전략이 필요합니다. 사용 가능한 접근 방식을 이해하면 특정 요구사항에 적합한 도구를 선택하는 데 도움이 됩니다.

정적 JSON 파일

정적 JSON 파일은 모의 데이터 생성의 가장 간단한 접근 방식입니다. 예측 가능한 API 동작과 제한된 데이터 변형 요구사항을 가진 기본 애플리케이션에 완벽합니다.

이러한 파일은 하드코딩된 값으로 API 응답의 예상 구조를 에뮬레이트합니다. 다음은 사용자 데이터를 시뮬레이션하기 위한 기본 정적 JSON 파일의 예입니다:

{
  "users": [
    { 
      "id": 1, 
      "name": "Alice Johnson", 
      "email": "[email protected]",
      "role": "admin",
      "createdAt": "2025-01-15T10:30:00Z"
    },
    { 
      "id": 2, 
      "name": "Bob Smith", 
      "email": "[email protected]",
      "role": "user",
      "createdAt": "2025-02-20T14:45:00Z"
    }
  ],
  "meta": {
    "total": 2,
    "page": 1,
    "perPage": 10
  }
}

정적 JSON 파일의 장점:

• 설정 복잡성 제로—파일을 생성하고 참조하기만 하면 됨
• 버전 관리 친화적—변경사항이 Git에서 추적됨
• 빠른 로드 및 파싱
• 외부 종속성이나 런타임 요구사항 없음

제한사항:

• 요청 매개변수에 기반한 동적 응답 시뮬레이션 불가
• 데이터 복잡성이 증가하면 유지관리 어려움
• CRUD 작업이나 상태 변경 지원 없음
• 각 테스트 시나리오마다 수동 업데이트 필요

정적 파일은 특정 입력 형식을 테스트하는 데 적합합니다. 예를 들어, 바코드 생성기와 같은 도구를 사용하여 테스트 바코드 값을 생성하거나 인증서 생성기를 사용하여 정적 JSON 파일에서 인증서 입력 시나리오를 검증할 수 있습니다.

json-server를 사용한 모의 서버

json-server 패키지는 최소한의 설정으로 완전한 가짜 REST API를 제공합니다. JSON 파일에서 자동으로 RESTful 엔드포인트를 생성하여 GET, POST, PUT, PATCH, DELETE 작업을 지원합니다.

npm을 통해 json-server를 전역으로 설치:

npm install -g json-server

데이터 구조로 db.json 파일 생성:

{
  "posts": [
    { "id": 1, "title": "First Post", "author": "Alice" }
  ],
  "comments": [
    { "id": 1, "postId": 1, "body": "Great post!" }
  ],
  "profile": { "name": "Admin User" }
}

서버 시작:

json-server --watch db.json --port 3001

이렇게 하면 http://localhost:3001에 다음과 같은 라우트를 가진 완전한 REST API가 생성됩니다:

• GET /posts - 모든 게시물 목록
• GET /posts/1 - ID가 1인 게시물 가져오기
• POST /posts - 새 게시물 생성
• PUT /posts/1 - ID가 1인 게시물 업데이트
• DELETE /posts/1 - ID가 1인 게시물 삭제

서버는 리소스 간의 필터링, 페이지네이션, 정렬 및 관계를 자동으로 처리합니다. 예를 들어, GET /posts?author=Alice는 작성자별로 게시물을 필터링하고, GET /posts?_page=2&_limit=10은 페이지네이션을 구현합니다.

Faker.js를 사용한 프로그래밍 방식 생성

현실적이고 다양한 데이터가 필요한 애플리케이션의 경우, Faker.js와 같은 프로그래밍 방식 생성 라이브러리가 강력한 기능을 제공합니다. 이러한 도구는 수십 개의 카테고리에 걸쳐 무작위이지만 현실적인 데이터를 생성합니다.

import { faker } from '@faker-js/faker';

function generateUser() {
  return {
    id: faker.string.uuid(),
    firstName: faker.person.firstName(),
    lastName: faker.person.lastName(),
    email: faker.internet.email(),
    avatar: faker.image.avatar(),
    birthDate: faker.date.birthdate(),
    registeredAt: faker.date.past(),
    address: {
      street: faker.location.streetAddress(),
      city: faker.location.city(),
      country: faker.location.country(),
      zipCode: faker.location.zipCode()
    }
  };
}

// 100명의 사용자 생성
const users = Array.from({ length: 100 }, generateUser);

Faker.js는 지역화를 지원하여 특정 지역에 적합한 데이터를 생성할 수 있습니다. 이름, 주소, 전화번호, 날짜, 금융 데이터 등을 위한 생성기를 포함합니다.

API 모킹 서비스

Mockoon, Postman Mock Server, WireMock과 같은 클라우드 기반 모킹 서비스는 다음을 포함한 엔터프라이즈급 기능을 제공합니다:

• 팀 협업 및 공유 모의 구성
• 고급 요청 매칭 및 응답 템플릿
• 성능 테스트를 위한 지연 시뮬레이션
• 요청 로깅 및 디버깅 도구
• CI/CD 파이프라인과의 통합

이러한 서비스는 여러 모의 API를 조정하는 것이 어려워지는 복잡한 마이크로서비스 아키텍처를 작업하는 대규모 팀에 특히 유용합니다.

모의 데이터 구현 시 주요 고려사항

효과적인 모의 데이터 구현에는 개발 효율성과 테스트 신뢰성 모두에 영향을 미치는 여러 중요한 요소에 대한 신중한 계획과 주의가 필요합니다.

데이터 현실성 및 다양성

모의 데이터는 프로덕션 데이터 특성을 밀접하게 반영해야 합니다. 여기에는 현실적인 값 범위, 적절한 데이터 타입, 엔티티 간의 진정한 관계가 포함됩니다. 비현실적인 모의 데이터는 애플리케이션 동작에 대한 잘못된 확신으로 이어집니다.

모의 데이터를 설계할 때 다음 측면을 고려하세요:

• 값 분포: 사용자의 80%가 세 국가 출신이라면, 모의 데이터도 유사한 분포를 반영해야 함
• 문자열 길이: 짧은 값과 매우 긴 값 모두로 테스트하여 잘림 문제 포착
• 특수 문자: 렌더링을 깨뜨릴 수 있는 유니코드 문자, 이모지, 특수 기호 포함
• Null 및 빈 값: UI가 누락된 데이터를 우아하게 처리하는지 확인
• 숫자 범위: 0, 음수, 매우 큰 값과 같은 경계 조건 테스트

가짜 데이터 생성기와 같은 도구는 다양하고 현실적인 데이터셋을 빠르게 생성하는 데 도움이 될 수 있습니다. 특정 데이터 형식을 테스트하려면 모의 데이터 생성기가 일반적인 데이터 구조에 대한 사용자 정의 가능한 템플릿을 제공합니다.

API 계약 충실도

모의 데이터는 실제 API 계약과 정확히 일치해야 합니다. 모의 API 응답과 실제 API 응답 간의 불일치는 프로덕션 엔드포인트로 전환할 때 통합 실패로 이어집니다.

다음을 통해 계약 충실도를 유지하세요:

1. OpenAPI/Swagger 사양을 단일 진실 공급원으로 사용
2. JSON 스키마에 대해 모의 응답 검증
3. 모의 API와 실제 API 모두를 검증하는 계약 테스트 구현
4. 프로덕션 API와의 의도적인 차이점 문서화

성능 특성

모의 API는 현실적인 응답 시간과 데이터 볼륨을 시뮬레이션해야 합니다. 즉각적인 응답과 작은 데이터셋으로만 테스트하면 프로덕션에서 나타나는 성능 문제가 가려집니다.

다음을 통해 성능 시뮬레이션을 구현하세요:

• 인위적인 지연 주입(일반적인 API 호출의 경우 100-500ms)
• 페이지네이션 테스트를 위한 대규모 데이터셋 생성
• 타임아웃 처리를 위한 느린 응답 시뮬레이션
• 스로틀링 동작을 테스트하기 위한 속도 제한

오류 시나리오 커버리지

프로덕션 API는 다양한 방식으로 실패합니다. 모의 데이터 전략에는 애플리케이션이 실패를 우아하게 처리하도록 보장하기 위한 오류 시나리오가 포함되어야 합니다.

모킹해야 할 필수 오류 시나리오:

동적 데이터를 활용한 고급 모킹

애플리케이션이 복잡해짐에 따라 정적 모의 데이터는 불충분해집니다. 고급 모킹 기술은 프로덕션 동작을 밀접하게 반영하는 정교한 테스트 시나리오를 가능하게 합니다.

상태 유지 모킹

상태 유지 모의는 요청 간에 데이터를 유지하여 완전한 사용자 워크플로우를 테스트할 수 있게 합니다. 새 리소스를 POST하면 후속 GET 요청이 해당 리소스를 반환해야 합니다.

json-server를 사용한 상태 유지 모킹 구현은 자동입니다—JSON 파일에 변경사항을 유지합니다. 사용자 정의 모의 서버의 경우 인메모리 데이터 저장소를 유지하세요:

const express = require('express');
const app = express();
app.use(express.json());

let users = [
  { id: 1, name: 'Alice', email: '[email protected]' }
];
let nextId = 2;

app.get('/users', (req, res) => {
  res.json(users);
});

app.post('/users', (req, res) => {
  const newUser = { id: nextId++, ...req.body };
  users.push(newUser);
  res.status(201).json(newUser);
});

app.put('/users/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const index = users.findIndex(u => u.id === id);
  if (index === -1) return res.status(404).json({ error: 'User not found' });
  
  users[index] = { ...users[index], ...req.body };
  res.json(users[index]);
});

app.listen(3001);

요청 기반 응답 변형

고급 모의는 요청 매개변수, 헤더 또는 본문 내용에 따라 다른 응답을 반환할 수 있습니다. 이를 통해 검색 기능, 필터링 및 조건부 로직을 테스트할 수 있습니다.

app.get('/users', (req, res) => {
  let result = [...users];
  
  // 역할별 필터링
  if (req.query.role) {
    result = result.filter(u => u.role === req.query.role);
  }
  
  // 이름으로 검색
  if (req.query.search) {
    const term = req.query.search.toLowerCase();
    result = result.filter(u => 
      u.name.toLowerCase().includes(term)
    );
  }
  
  // 페이지네이션
  const page = parseInt(req.query.page) || 1;
  const limit = parseInt(req.query.limit) || 10;
  const start = (p