API 우선 접근 방식이 Zonos의 미래를 어떻게 형성하고 있는가?

API 우선 접근 방식이란 무엇인가? 

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

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

API 우선 접근 방식의 이점 

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

• 우리는 우리의 API가 고객을 위한 주요 인터페이스라는 것을 이해하고, 따라서 이를 우리의 공개 산출물로 간주합니다.
• 코드를 작성하기 전에 문서화함으로써, 우리는 목표를 팀과 이해관계자와 논의하고 정제하며 소통할 기회를 가집니다. 이를 통해 더 나은 최종 제품을 만들 수 있습니다.
• 고객의 요구에 집중함으로써, 우리는 이러한 요구를 충족하는 API를 설계하는 방법을 이해합니다.

이 사고 방식은 우리의 API와 고객을 최우선으로 두며, Zonos의 모든 사람이 고객 성공에 책임을 지는 기반을 확립하는 데 중요합니다.

개발 팀이 병렬로 작업할 수 있음

API 우선 접근 방식은 계약을 수립하는 것을 포함합니다. 서비스 간의 계약을 생성하면 조직 내의 팀들이 동시에 여러 API에서 작업할 수 있습니다. 개발자는 다음 API로 넘어가기 전에 API 업데이트가 출시되기를 기다릴 필요가 없습니다. 팀은 미리 설정된 API 정의를 기반으로 API와 API 종속성을 동시에 모의 테스트할 수 있습니다.

개발 비용 절감

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

시장 출시 속도 증가

API 구축 과정의 많은 부분은 API 정의 파일을 가져오는 도구를 사용하여 자동화할 수 있습니다. 우리는 핵심 유형, 정의 및 스키마를 생성하는 것으로 시작합니다. 이러한 파일을 통해 API 문서화, 소프트웨어 개발 키트(SDK) 및 모의 API와 같은 API 도구를 자동으로 생성할 수 있습니다. 자동화는 API 및 애플리케이션 개발 속도를 크게 높입니다.

API 우선 접근 방식은 또한 전체 시스템을 재구성하지 않고도 애플리케이션에 새로운 서비스와 기술을 추가할 수 있게 합니다. Zonos는 변화하는 크로스 보더 SaaS 시장에서 경쟁력을 유지하기 위해 기능을 신속하게 생산에 배포해야 합니다. 잘못 설계된 API에서 고객을 이전하는 것보다 기본 코드에서 기술 부채를 제거하는 것이 더 쉽습니다.

좋은 개발자 경험 보장

API 소비자는 대부분 개발자이며, 개발자 경험(DX)은 API의 성공을 좌우할 수 있습니다. API 우선 접근 방식은 잘 설계되고 잘 문서화된 일관된 API가 배우고 재사용하기 쉬워 개발자 경험이 긍정적이도록 보장합니다. 이는 구현 속도를 증가시킵니다. 이러한 이점은 모두 상호 연결되어 있습니다!

장기적인 성공 증가

API 우선 접근 방식은 빠른 프로토타입 제작과 반복을 가능하게 하여, 우리가 무엇이 효과적이고 무엇이 효과적이지 않은지를 더 빨리 배울 수 있게 합니다. 에디슨이 전구를 만들기 전에 1,000번의 실패를 겪었던 것처럼, API 우선 접근 방식은 우리가 빠르게 실패하고 성공을 달성하는 방법에 대한 더 나은 이해를 가지고 앞으로 나아가게 합니다. API 우선 접근 방식은 API가 신뢰할 수 있고 일관되며 개발자가 사용하기 쉬운 것을 보장함으로써 우리의 장기적인 성공을 증가시킵니다.

왜 역으로 작업하는 것이 효과적인가? 

2015년, 나는 인기 소비자 브랜드의 전자상거래 사이트를 재설계할 기회를 가졌습니다. 기존 시스템과 관련된 다양한 주요 성과 지표(KPI)를 평가했으며, 가장 큰 개선이 이루어질 수 있는 곳은 clear 것이었습니다:

• 데스크탑 전환 rate이 기준 이하였습니다.
• 모바일 전환 rate이 끔찍했습니다.
• 모바일 트래픽의 비율이 빠르게 증가하고 있으며, 향후 12개월 내에 전체 트래픽의 50%를 초과할 것입니다. 끔찍한 모바일 전환 rate 때문에 대부분의 모바일 트래픽은 이상적이지 않았습니다.

주어진 데이터를 바탕으로 사용자에게 가장 큰 가치를 창출할 수 있는 것은 무엇일까요? 분명했습니다: 사이트의 모바일 사용자 경험 문제를 해결하는 것이었습니다. 따라서 나는 모바일 우선 접근 방식을 취하여 사이트를 재설계했습니다. 이는 모든 디자인, 아키텍처, API 등이 먼저 모바일 경험을 고려하도록 하는 것을 의미했습니다. 이는 당시 전통적인 접근 방식과는 반대였으며, 전통적인 접근 방식은 종종 데스크탑 경험에 먼저 초점을 맞추고 모바일 경험을 서투르게 추가하는 방식이었습니다. 모바일 우선 접근 방식은 또한 초기 단계에서 더 많은 노력을 요구했습니다. 이는 쉬운 길이 아니었습니다. 새로운 아키텍처가 필요했고, 새로운 API를 작성해야 했으며, 모든 브레이크포인트에 대해 여러 디자인이 필요했습니다.

모바일 우선 접근 방식은 모바일 전환 rate의 상당한 증가를 가져왔습니다. 새로운 아키텍처는 데스크탑 전환 rate에서도 인상적인 성과를 거두었습니다. 이 접근 방식은 최대 사용자 가치를 창출하는 방법을 식별하고 그 가치를 제공하는 데 전체 접근 방식을 집중시켰기 때문에 성공적이었습니다. 처음부터 올바른 사고 방식을 만들었습니다. 마찬가지로, 비록 역으로 작업하는 것처럼 느껴질 수 있지만, API 우선 접근 방식은 포괄적인 문제를 식별하고 이러한 문제를 수정할 수 있는 기반을 구축할 기회를 창출합니다.

엔지니어링 책임이란 무엇인가? 

API 우선 사고방식은 Zonos의 성공을 이끌어 왔으며 앞으로도 계속 그럴 것입니다. 엔지니어링은 이 과정에서 중요한 역할을 합니다. 우리는 항상 API 우선 사고방식을 유지할 책임이 있습니다. 이는 고객의 요구를 충족하기 위해 우리의 API에 초점을 맞춘 질문을 끊임없이 던진다는 것을 의미합니다. 예를 들어: “우리의 API가 고객의 요구를 어떻게 충족할 수 있을까” 또한 기능 및 기능에 대한 질문에 항상 API 문서에 대한 링크와 함께 응답해야 함을 의미합니다. 문서가 존재하지 않는 경우, 우리는 이를 작성합니다—Zonos가 뛰어난 API 문서를 갖출 수 있도록 교차 기능 팀과 협력합니다.