Easy Welfare Lab.

API 연동 기초

API는 다른 서비스의 데이터를 가져오는 통로입니다. fetch로 외부 데이터를 받아 화면에 표시하는 흐름을 익혀 앱의 가능성을 넓힙니다.


API가 뭔가요?

API는 다른 서비스에 데이터를 요청하고 돌려받는, 미리 정해진 통로입니다. 날씨, 환율, 공공데이터처럼 직접 만들지 않은 정보도 내 페이지로 불러올 수 있게 해줍니다. 정해진 방식으로 “이 정보를 주세요”라고 요청하면, 약속된 형태로 데이터가 돌아옵니다.

fetch로 데이터 가져오기

자바스크립트의 fetch 는 API에 요청을 보내는 기본 도구입니다.

  1. 연습용으로 누구나 쓸 수 있는 공개 테스트 API를 사용합니다.

    fetch("https://jsonplaceholder.typicode.com/users")
      .then((response) => response.json())
      .then((data) => {
        console.log(data);
      });
  2. 페이지를 열고 콘솔(F12)을 보면 사용자 목록 데이터가 출력됩니다.

  3. console.log 대신, 받은 데이터를 화면에 그려봅니다.

    fetch("https://jsonplaceholder.typicode.com/users")
      .then((res) => res.json())
      .then((users) => {
        const list = document.getElementById("userList");
        users.forEach((user) => {
          const li = document.createElement("li");
          li.textContent = user.name;
          list.appendChild(li);
        });
      });

이 흐름은 “요청 → JSON으로 변환 → 화면에 표시”입니다. 거의 모든 API 연동이 이 형태를 따릅니다.

fetch 요청에서 JSON 응답을 받아 화면에 목록으로 표시하는 흐름도
내 페이지가 fetch로 요청하면 외부 API가 JSON으로 응답하고, 그 데이터를 화면에 표시합니다.

비동기를 이해하기

API 요청은 시간이 걸립니다. 그래서 데이터가 도착한 “다음에” 처리하도록 .then() 으로 이어 붙입니다. 더 읽기 쉬운 async/await 방식도 있는데, 필요할 때 AI에게 “이 fetch 코드를 async/await로 바꿔줘”라고 요청해 비교해보세요.

다음 단계

이제 만든 것을 세상에 보여줄 차례입니다. 내 웹사이트를 인터넷에 배포하는 법을 배웁니다.