프런트엔드 개발자로서 프런트엔드를 완전히 구현하기 전에 API를 완료하기 위해 백엔드에서 기다리는 것이 일반적입니다. 다행히 MockAPI.io와 같은 도구를 사용하면 작업 백엔드를 시뮬레이션하여 지연 없이 애플리케이션의 프런트엔드 부분 코딩을 진행할 수 있습니다.

이 블로그 게시물에서는 실제 백엔드가 개발되는 동안 MockAPI.io를 새로운 Next.js 앱에 통합하여 백엔드 데이터를 모의하는 방법을 살펴보겠습니다.

MockAPI.io란 무엇인가요?

MockAPI.io는 개발자가 모의 REST API를 만들 수 있는 사용하기 쉬운 플랫폼입니다. 이 도구를 사용하면 실제 API 엔드포인트를 시뮬레이션하고, 리소스(데이터 모델)를 정의하고, 실제 백엔드 없이도 애플리케이션을 테스트할 수 있습니다. 특히 프론트엔드 개발과 프로토타입 제작에 유용합니다.

MockAPI.io를 사용하는 이유는 무엇입니까?

독립적으로 작업: 프런트엔드 작업을 시작하기 전에 백엔드 개발이 완료될 때까지 기다릴 필요가 없습니다.
더 빠른 반복: 엔드포인트를 빠르게 모의하고 다양한 시나리오를 테스트할 수 있습니다.
API 시뮬레이션: 실제 API의 구조를 시뮬레이션하여 준비가 되면 실제 백엔드로 원활하게 전환할 수 있습니다.
협업에 적합: 예상 API 구조를 정의하여 백엔드 개발자와 긴밀하게 협력할 수 있습니다.

단계별 가이드: Next.js 앱으로 MockAPI.io 설정

1. 새로운 Next.js 앱 만들기
먼저, 새로운 Next.js 프로젝트를 생성해 보겠습니다. 다음 명령을 실행하여 앱을 초기화하세요.

npx create-next-app@latest mockapi-nextjs-app

프로젝트 디렉토리로 이동:

cd mockapi-nextjs-app

개발 서버를 시작하여 모든 것이 제대로 설정되었는지 확인하세요.

npm run dev

이제 앱이 http://localhost:3000에서 실행될 것입니다.

2. MockAPI.io 계정 만들기
다음으로, 아직 계정이 없다면 MockAPI.io에 가입하세요. 로그인 후 새 프로젝트 생성 버튼을 클릭하여 새 프로젝트를 생성할 수 있습니다.

3. 리소스 생성(끝점)
프로젝트가 생성되면 "Users":

리소스 추가를 클릭하고 이름을 "사용자"로 지정합니다.
ID, 이름, 이메일, 아바타(사용자 프로필 사진용) 등의 속성을 정의합니다.
MockAPI.io는 가짜 사용자 데이터를 자동으로 생성합니다.
이제 다음과 같은 API 엔드포인트 목록이 표시됩니다.

GET /users - 모든 사용자를 가져옵니다.
POST /users - 새 사용자를 만듭니다.
PUT /users/{id} - 사용자를 업데이트합니다.
DELETE /users/{id} - 사용자를 삭제합니다.
API의 기본 URL은 https://mockapi.io/projects/{your_project_id}/users.

4. Next.js의 MockAPI에서 데이터 가져오기
이제 모의 API가 있으므로 Next.js의 getServerSideProps 또는 getStaticProps를 사용하여 이를 Next.js 앱에 통합할 수 있습니다. /users 엔드포인트에서 데이터를 가져와서 앱에 표시해 보겠습니다.

Next.js 프로젝트에서 getServerSideProps를 사용하여 MockAPI.io에서 사용자 데이터를 가져오는 방법은 다음과 같습니다.

pages/users.js에서 새 페이지를 만듭니다.

import React from 'react';
import axios from 'axios';

const Users = ({ users }) => {
  return (
    

      
User List
      

        {users.map((user) => (
          

            
            {user.name} - {user.email}
          
        ))}
      
  );
};

// Fetch data on each request (SSR)
export async function getServerSideProps() {
  try {
    const response = await axios.get('https://mockapi.io/projects/{your_project_id}/users');
    const users = response.data;

    return {
      props: { users }, // Will be passed to the page component as props
    };
  } catch (error) {
    console.error("Error fetching users:", error);
    return {
      props: { users: [] },
    };
  }
}

export default Users;

이 예에서는:

getServerSideProps는 모의 API 엔드포인트에서 사용자 데이터를 가져오기 위해 서버 측 요청을 만듭니다.
사용자 목록은 프로필 사진, 이름, 이메일로 렌더링됩니다.

5. 모의 API 통합 테스트
개발 서버를 실행하여 통합을 테스트합니다.

npm run dev

http://localhost:3000/users로 이동하면 MockAPI.io에서 가져온 사용자 목록이 Next.js 앱에 표시됩니다.

6. 새로운 기능 추가: 사용자 생성
Next.js 앱의 양식을 통해 새 사용자를 생성할 수 있는 기능을 추가해 보겠습니다. MockAPI 엔드포인트에 POST 요청을 보내겠습니다.

pages/add-user.js에서 양식 구성 요소를 생성합니다:

import { useState } from 'react';
import axios from 'axios';

const AddUser = () => {
  const [name, setName] = useState('');
  const [email, setEmail] = useState('');
  const [avatar, setAvatar] = useState('');

  const handleSubmit = async (e) => {
    e.preventDefault();

    try {
      const response = await axios.post('https://mockapi.io/projects/{your_project_id}/users', {
        name,
        email,
        avatar
      });
      console.log("User added:", response.data);
    } catch (error) {
      console.error("Error adding user:", error);
    }
  };

  return (
    

      
Add New User
      

         setName(e.target.value)}
        />
         setEmail(e.target.value)}
        />
         setAvatar(e.target.value)}
        />
        Add User
      
    
  );
};

export default AddUser;

이제 양식을 제출하면 MockAPI에 새 사용자가 생성됩니다.

7. 실제 백엔드로 전환
실제 백엔드가 준비되면 모의 API를 교체하는 것은 간단합니다. 실제 백엔드를 가리키도록 axios 요청의 기본 URL을 업데이트하면 앱이 구조 변경 없이 원활하게 작동해야 합니다.

결론

Next.js와 함께 MockAPI.io를 사용하는 것은 백엔드가 아직 진행 중인 경우에도 프런트엔드 애플리케이션을 구축하고 테스트할 수 있는 훌륭한 방법입니다. 실제 API 상호 작용을 시뮬레이션함으로써 프런트엔드 개발을 계속 진행하고 실제 백엔드가 완료된 후 원활한 전환을 보장할 수 있습니다.

대규모 팀에서 작업하든 솔로 프로젝트에서 작업하든 MockAPI.io는 프런트엔드 개발자에게 유용한 도구입니다. 지금 바로 사용을 시작하여 개발 프로세스를 간소화하세요!