3Min API를 만든 이유 — 한 통의 전화에서 시작된 이야기

안녕하세요, 3Min API에서 개발자 경험(DX)을 담당하고 있는 채원이에요.

이 서비스를 만들기 전, 저는 다른 팀들의 백엔드를 대신 만들어주는 일을 꽤 오래 했어요. 그러다 보니 거의 예측 가능한 수준으로 반복되는 요청이 하나 있었는데요.

"저희 개발팀이 없는데, 거래처에서 판매 데이터를 API로 연동하고 싶다고 하거든요. 도와주실 수 있나요?"

작은 이커머스 회사, 직원 다섯 명 규모의 물류 스타트업, 큰 파트너사를 막 확보한 마케팅 에이전시. 회사는 달랐지만 문제의 모양은 항상 같았어요.

자체 백엔드가 없고, 만들 사람도 없는데, 거래처 — 보통 훨씬 큰 회사 — 에서 데이터를 프로그래밍 방식으로 보내고 싶어 하는 거예요. 이메일에 엑셀 첨부하는 방식은 더 이상 통하지 않는 시대니까요.

반복되는 사이클

그래서 빠르게 백엔드를 하나 만들어요. 간단하게 — JSON 받고, 저장하고, 기본적인 관리자 화면 하나 붙이는 정도. 배포하고, API 문서 넘기고, 끝.

그런데 몇 달 뒤에 또 연락이 와요.

"새로운 거래처가 생겼는데, 그쪽도 연동하고 싶대요. 데이터 형식이 좀 달라서요."

다시 원점. 새 엔드포인트, 새 스키마, 새 관리자 화면. 또 테스트, 또 배포. 또 비용.

이런 일회성 프로젝트가 쌓이다 보면 데이터가 흩어지기 시작해요. 첫 번째 연동은 이 서버에, 두 번째는 저 서버에. 뭐가 들어오고 있는지 한눈에 보이지 않고, 테스트 환경은 엉망이거나 아예 없고. 게다가 그 모든 수고를 들이고 나서, 실제로는 한 달에 몇 백 건밖에 호출이 없는 경우도 있었어요. 들인 비용과 시간이 아까울 정도로요.

이 패턴을 수년간 지켜봤어요. 한 곳이 아니라 수십 곳에서요. 같은 고통, 같은 낭비, 같은 반복.

생각보다 치명적인 문제

빠르게 변하는 비즈니스 환경에서, 이런 마찰은 단순한 불편함이 아니라 실질적인 약점이에요. 연동 하나 세팅하는 데 몇 주를 쓰는 동안, 경쟁사는 이미 데이터를 받기 시작하고 있거든요.

소규모 팀은 새 파트너가 생길 때마다 인프라를 처음부터 다시 만들 여유가 없어요. 빠르게 연동하고, 비즈니스가 되는지 확인하고, 매출이 나면 그때 확장하는 게 합리적이에요.

빠르게 연동하고, 빠르게 배우고, 준비되면 확장한다. 완전히 합리적인 전략이죠. 그런데 당시 사용할 수 있는 도구들은 이런 접근을 지원하지 않았어요. 대부분 개발팀이 있다는 전제 하에 설계되어 있었거든요.

필요하다고 느낀 것

같은 질문이 계속 머릿속에 맴돌았어요. 몇 주가 아니라 몇 분 만에 API 엔드포인트를 세팅할 수 있다면 어떨까?

요즘 대부분의 시스템은 JSON으로 통신해요. 그게 현실이에요. 그러면 어차피 JSON인데, 굳이 관계형 데이터베이스 스키마를 먼저 정의해야 할 이유가 있을까요? 받고 싶은 데이터의 형태만 기술하면 바로 수신을 시작할 수 있으면 좋겠다고 생각했어요. NoSQL에 가까운 컨셉 — 유연하고, 세팅이 빠르고, 변경이 쉬운.

하지만 데이터를 받는 건 절반일 뿐이에요. 많은 팀이 들어온 데이터를 자기 데이터베이스나 CRM, 스프레드시트 같은 기존 도구로 보내고 싶어 했거든요. 그래서 웹훅을 넣었어요. 데이터가 도착하면 원하는 곳으로 자동 전달되는 방식이에요.

뭔가 깨지기 전까지는 생각하지 않는 것들

프로덕션에서 운영이 시작되면, 안정성이 전부예요. 서버에 문제가 생겼다고 데이터가 사라지면 안 되잖아요. 그래서 재시도 로직과 복구 기능을 만들었어요. 문제가 발생해도 최대 56시간 동안 데이터가 보존되기 때문에, 아무것도 잃지 않고 문제를 해결할 시간이 생겨요.

장애 알림도 넣었어요. 연동이 끊기거나 웹훅이 실패하면 바로 알림이 와요. 사소해 보일 수 있지만, 전담 운영 엔지니어가 없는 팀에게는 정말 중요해요. 문제를 몇 분 만에 발견하느냐, 며칠 뒤에 거래처 전화를 받고 알게 되느냐의 차이거든요.

그리고 조금 더 조용한 니즈도 있어요. 연동이 시간이 지나면서 어떻게 되고 있는지 보여주는 통계 기능 — 호출 수, 추이, 성장세를 관찰할 수 있어요. 아카이브 기능으로 데이터를 JSONL 형식으로 다운받아 별도의 분석을 할 수도 있고요. 화려한 기능은 아니지만, 비즈니스를 이해하려 할 때 진짜 차이를 만들어주는 것들이에요.

지금은

요즘 비슷한 요청이 오면 — "API가 필요한데 개발팀이 없어요" — 저희는 먼저 3Min API를 알려드려요. 영업 차원이 아니라, 그 대화의 반대편에 충분히 서봤기 때문에 그 고통을 아는 거예요.

모든 문제를 해결하진 않아요. 복잡한 비즈니스 로직이나 깊은 커스터마이징이 필요하다면 언젠가 넘어서게 될 수도 있어요. 괜찮아요 — 원래 그런 거예요. 오늘 당장 동작하는 것부터 시작하고, 준비되면 그다음 단계를 고민하면 돼요.

혹시 이 이야기가 익숙하게 느껴지신다면 — 일회성 백엔드와 흩어진 데이터의 반복을 겪어 보셨다면 — 한번 둘러보셔도 좋을 것 같아요. 저희가 필요해서 만든 거예요. 어쩌면 여러분에게도 도움이 될 수 있을 거예요.

참, 3Min API가 우리 상황에 맞을까 궁금하시다면 — ChatGPT, Gemini, Claude에 https://3minapi.com/llms-full.txt 와 함께 물어보세요. 같이 고민해 줄 거예요.