API-first 접근 방식이 Zonos의 미래를 만들어가는 방법

API-first 접근 방식이란 무엇인가? 

API-first 접근 방식은 팀이 애플리케이션의 기능을 설계하고 코드를 작성한 다음 프로세스 마지막에 API를 추가하는 코드 우선 접근 방식과 명확히 대조됩니다.

Zonos에서 API-first 접근 방식으로 소프트웨어를 구축한다는 것은 애플리케이션을 코딩한 후 나중에 API를 추가하는 것이 아니라, API를 중심으로 솔루션을 설계하는 것을 의미합니다. 즉, 우리의 API는 그 자체로 가장 중요한 제품이며, 우리는 고객의 요구에 철저히 집중하여 API를 설계하고, 코드를 작성하기 전에 명확하게 문서화하고 설계합니다.

API-first 접근 방식의 장점 

API-first 접근 방식은 다음과 같은 사고방식을 확립하는 데 도움이 됩니다:

• 우리는 API가 고객을 위한 주요 인터페이스임을 이해하고 있으며, 따라서 이를 공개적인 결과물로 간주합니다.
• 코드를 작성하기 전에 문서화하면 팀 및 관계자와 함께 목표를 논리적으로 검토하고, 논의하고, 개선하고, 전달할 기회를 얻게 되어 더 나은 최종 제품을 만들 수 있습니다.
• 고객의 요구에 집중함으로써 우리는 해당 요구를 충족하는 API를 설계하는 최선의 방법을 이해하게 됩니다.

이러한 사고방식은 API와 고객을 최우선으로 두며, Zonos의 모든 구성원이 고객의 성공에 책임을 지는 기반을 마련하는 데 매우 중요합니다.

개발팀이 병렬로 작업할 수 있습니다

API-first 접근 방식에는 계약(contract)을 수립하는 과정이 포함됩니다. 조직 전체의 팀이 따르는 서비스 간 계약을 만들면 여러 팀이 동시에 여러 API 작업을 진행할 수 있습니다. 개발자는 다음 API로 넘어가기 전에 API 업데이트가 배포되기를 기다릴 필요가 없습니다. 팀은 사전에 정의된 API 정의를 기반으로 API와 API 종속성을 동시에 모의 테스트할 수 있습니다.

개발 비용을 절감합니다

API와 코드는 다양한 프로젝트에서 재사용할 수 있습니다. API-first 접근 방식에서는 개발팀이 새로운 애플리케이션을 구축하고자 할 때 처음부터 시작할 필요가 없어 시간과 비용을 절약할 수 있습니다. 또한 API-first 설계는 코드를 작성하기 전에 대부분의 문제를 해결할 수 있도록 해주므로, API를 애플리케이션에 통합할 때 발생할 수 있는 문제를 예방하는 데 도움이 됩니다.

출시 속도를 높입니다

API를 구축하는 과정의 많은 부분은 API 정의 파일을 가져오는 도구를 사용하여 자동화할 수 있습니다. 우리는 먼저 핵심 타입, 정의, 스키마를 생성하며, 이 파일을 기반으로 API 문서, 소프트웨어 개발 키트(SDK), 모의 API와 같은 API 도구를 자동으로 생성할 수 있습니다. 자동화는 API와 애플리케이션 개발 속도를 크게 높여줍니다.

또한 API-first를 통해 전체 시스템을 다시 설계하지 않고도 애플리케이션에 새로운 서비스와 기술을 추가할 수 있습니다. Zonos는 끊임없이 변화하는 크로스보더 SaaS 시장에서 경쟁력을 유지하기 위해 기능을 신속하게 프로덕션에 배포해야 합니다. 잘못 설계된 API에서 고객을 마이그레이션하는 것보다 기반 코드의 기술 부채를 제거하는 것이 더 쉽습니다.

우수한 개발자 경험을 보장합니다

API 사용자는 대부분 개발자이며, 개발자 경험(DX)은 API의 성공 여부를 좌우할 수 있습니다. API-first 접근 방식은 잘 설계되고 잘 문서화된 일관된 API가 배우고 재사용하기 쉽기 때문에 긍정적인 개발자 경험을 보장합니다. 이는 구현 속도도 높여줍니다. 이러한 장점들은 모두 서로 연결되어 있습니다!

장기적인 성공을 높입니다

API-first 접근 방식은 빠른 프로토타이핑과 반복 작업을 가능하게 하여 무엇이 효과적이고 무엇이 그렇지 않은지 더 빠르게 파악할 수 있게 해줍니다. 에디슨이 전구를 발명하기까지 1,000번의 실패를 거쳤던 것처럼, API-first는 우리가 빠르게 실패하고 성공을 달성하는 방법에 대한 더 나은 이해를 바탕으로 앞으로 나아간다는 것을 의미합니다. API-first는 API가 안정적이고 일관되며 개발자가 사용하기 쉽도록 보장함으로써 우리의 장기적인 성공을 높여줍니다.

역방향으로 작업하는 것이 효과적인 이유는 무엇인가? 

2015년, 저는 유명 소비자 브랜드의 이커머스 사이트를 재설계할 기회가 있었습니다. 기존 시스템과 관련된 다양한 핵심 성과 지표(KPI)를 평가한 결과, 가장 큰 개선이 필요한 부분이 명확하게 드러났습니다:

• 데스크톱 전환율이 기준 이하였습니다.
• 모바일 전환율은 매우 저조했습니다.
• 모바일 트래픽 비율이 급속히 증가하고 있었으며, 앞으로 12개월 이내에 전체 트래픽의 50%를 넘어설 것으로 예상되었습니다. 모바일 전환율이 매우 저조했기 때문에, 트래픽의 대부분이 모바일이라는 사실은 바람직하지 않았습니다.

이 데이터를 바탕으로, 사용자에게 가장 큰 가치를 창출하는 방법은 무엇일까요? 답은 분명했습니다: 사이트의 모바일 사용자 경험 문제를 해결하는 것이었습니다. 그래서 저는 모바일 우선 접근 방식으로 사이트를 재설계했습니다. 이는 모든 디자인, 아키텍처, API 등이 모바일 경험을 가장 먼저 고려한다는 것을 의미했습니다. 이는 당시 데스크톱 경험을 먼저 고려하고 모바일 경험을 어설프게 덧붙인 부수적 요소로 남겨두어 전환율이 저조했던 전통적인 접근 방식과는 반대되는 방식이었습니다. 모바일 우선 접근 방식은 또한 더 많은 사전 노력이 필요했습니다. 결코 쉬운 길이 아니었습니다. 새로운 아키텍처가 필요했고, 새로운 API를 작성해야 했으며, 모든 브레이크포인트마다 여러 디자인이 필요했습니다.

모바일 우선 접근 방식은 모바일 전환율의 큰 증가로 이어졌습니다. 새로운 아키텍처 역시 데스크톱 전환율에서 인상적인 향상을 가져왔습니다. 이 접근 방식이 성공한 이유는 사용자에게 최대의 가치를 창출하는 방법을 파악하고, 그 가치를 제공하는 데 전체 접근 방식을 집중했기 때문입니다. 이는 처음부터 올바른 사고방식을 만들어냈습니다. 마찬가지로—비록 역방향으로 작업하는 것처럼 느껴질 수 있지만—API-first 접근 방식은 전반적인 문제를 파악하고 그 문제를 해결할 기반을 구축할 기회를 만들어냅니다.

엔지니어링의 책임은 무엇인가? 

API-first 사고방식은 지금까지 Zonos를 성공으로 이끌어왔고 앞으로도 계속 그럴 것이며, 엔지니어링은 그 안에서 필수적인 역할을 합니다. API-first 사고방식을 항상 유지하는 것은 우리의 책임입니다. 이는 우리가 끊임없이 API에 초점을 맞춘 질문, 예를 들어 “우리의 API가 고객의 요구를 어떻게 충족할 수 있는지”와 같은 질문을 던진다는 것을 의미합니다. 또한 이는 기능과 특징에 대한 질문에 항상 API 문서 링크로 응답한다는 것을 의미합니다. 문서가 존재하지 않는다면 우리가 직접 만들며—여러 부서의 팀과 함께 협력하여 Zonos가 훌륭한 API 문서를 갖추도록 합니다.