<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/">
  <channel>
    <title>Software Development · 인재덕</title>
    <link>https://jared.lynskey.co.nz/ko/tags/software-development/</link>
    <description>소프트웨어 엔지니어링과 개발 조직 리더십에 대한 이야기. 성과 리뷰, 채용과 팀 확장, CI/CD, 데브옵스 모니터링, 에이전틱 AI. 서울에서 씁니다.</description>
    <generator>Hugo</generator>
    <language>ko</language>
    <copyright>© 2026 인재덕</copyright>
    <lastBuildDate>Wed, 28 Oct 2026 00:00:00 +1300</lastBuildDate>
    <atom:link href="https://jared.lynskey.co.nz/ko/tags/software-development/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>API 우선 개발(API-First)과 OpenAPI: 프론트엔드와 백엔드를 병렬로 개발하기</title>
      <link>https://jared.lynskey.co.nz/ko/posts/2023/2023-10-08-open-api/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/ko/posts/2023/2023-10-08-open-api/</guid>
      <pubDate>Sun, 08 Oct 2023 00:30:03 +0000</pubDate>
      <dc:creator>Jared Lynskey</dc:creator>
      <category>OpenAPI</category>
      <category>Backend</category>
      <category>Frontend</category>
      <category>API Design</category>
      <category>Software Development</category>
      <category>Team Collaboration</category>
      <description>API 우선 개발을 실무에서 하는 법: OpenAPI 계약에 먼저 합의하고 목 서버를 띄우면, 프론트엔드가 더 이상 백엔드를 기다리지 않아도 됩니다.</description>
      <content:encoded><![CDATA[<p>지금까지 본 것 중 일정을 가장 확실하게 망치는 건 어려운 엔지니어링이 아닙니다. &ldquo;거의 다 됐다&quot;는 엔드포인트를 프론트엔드가 하염없이 기다리는 상황이죠. 회사에서 정착시킨 해법은 지루하지만 잘 듣습니다. 코드를 쓰기 전에 OpenAPI로 API 계약부터 합의하는 겁니다.</p>

<h3 class="relative group">기다림의 게임
    <div id="기다림의-게임" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%ea%b8%b0%eb%8b%a4%eb%a6%bc%ec%9d%98-%ea%b2%8c%ec%9e%84" aria-label="앵커">#</a>
    </span>
    
</h3>
<p>전통적인 흐름은 직렬입니다. 백엔드가 API를 설계하고 구현한 뒤, 엔드포인트가 실제로 동작해야 프론트엔드가 통합을 시작합니다. 백엔드의 지연은 전부 프론트엔드 일정에 그대로 얹히는데, 릴리스 날짜가 적혀 있는 곳이 대개 프론트엔드 일정표입니다.</p>

<h3 class="relative group">코드보다 계약이 먼저
    <div id="코드보다-계약이-먼저" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%ec%bd%94%eb%93%9c%eb%b3%b4%eb%8b%a4-%ea%b3%84%ec%95%bd%ec%9d%b4-%eb%a8%bc%ec%a0%80" aria-label="앵커">#</a>
    </span>
    
</h3>
<p>스키마 우선 흐름에서는 양쪽이 거의 동시에 출발합니다. 코드가 한 줄도 없는 시점에 API 구조를 OpenAPI 스키마로 적어 둡니다. 모든 엔드포인트, 요청·응답 모델, 인증 방식, 에러 코드까지요. 이 문서가 프론트엔드와 백엔드 사이의 계약서가 됩니다.</p>
<p>효과는 바로 나타납니다. 만들기 전에 모두가 기능을 같은 모양으로 이해하게 됩니다. 백엔드가 구현 중인 동안 프론트엔드는 UI를 만들 수 있고요. 합의된 단일 진실 공급원 하나만 고치면 되니 변경도 빨리 돕니다. 게다가 스키마에서 바로 목 서버를 생성할 수 있어서, 진짜 엔드포인트가 하나도 없는 단계부터 프론트엔드 테스트가 시작됩니다.</p>

<h3 class="relative group">실제로 돌리는 순서
    <div id="실제로-돌리는-순서" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%ec%8b%a4%ec%a0%9c%eb%a1%9c-%eb%8f%8c%eb%a6%ac%eb%8a%94-%ec%88%9c%ec%84%9c" aria-label="앵커">#</a>
    </span>
    
</h3>
<ol>
<li>요구사항을 모읍니다. 뭘 만들든 똑같죠.</li>
<li>스키마를 설계합니다. 엔드포인트, 요청/응답 모델, 인증, 에러 코드.</li>
<li>프론트엔드와 백엔드 양쪽이 함께 리뷰합니다. 계약이 제값을 하는 순간이 바로 여기입니다.</li>
<li>목 서버를 생성하고(Swagger, Postman 둘 다 됩니다) 프론트엔드는 그걸 상대로 통합을 진행합니다.</li>
<li>백엔드는 같은 스키마에 맞춰 진짜 엔드포인트를 구현합니다.</li>
<li>완성되는 대로 목을 진짜 엔드포인트로 갈아 끼우고, 계약이 지켜지는지 계속 테스트합니다.</li>
<li>대화를 이어갑니다. 스키마는 살아 있는 문서지 석판이 아니니까요.</li>
</ol>

<h3 class="relative group">걸리는 부분
    <div id="걸리는-부분" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%ea%b1%b8%eb%a6%ac%eb%8a%94-%eb%b6%80%eb%b6%84" aria-label="앵커">#</a>
    </span>
    
</h3>
<p>공짜는 아닙니다. 꼼꼼한 스키마를 미리 쓰는 데는 실제로 시간이 듭니다. 요구사항이 바뀌면 스키마부터 고쳐야 하고, 그 파장은 두 팀 모두에 미칩니다. 그리고 전원이 OpenAPI와 주변 도구에 최소한의 감은 갖고 있어야 하죠.</p>
<p>그래도 이 선행 투자가, 그 덕에 막을 수 있는 통합 지옥에 지는 걸 본 적이 없습니다. 프론트엔드는 첫날부터 달리기 시작하고, 논쟁은 깨진 빌드가 아니라 문서 위에서 벌어지게 됩니다.</p>
]]></content:encoded>
      <media:content url="https://jared.lynskey.co.nz/en/posts/2023/2023-10-08-open-api/featured.jpg" medium="image" type="image/jpeg" />
    </item>
  </channel>
</rss>
