API 목적이 비즈니스 문제의 해결에 있다는 사실을 다시 한번 상기시키는 책이다. 애플리케이션 현대화의 흐름 속에서 비동기화, 마이크로서비스 등 기술적인 관점에만 머무르기 쉬운 관점을 넓혀준다. 또한 비즈니스의 특성을 어떻게 API 설계와 구현으로 풀어낼 것인지, 개발 이후에도 지속되는 변경사항을 효율적으로 API에 반영해 비즈니스 환경 변화에 대응하는 방법론과 절차를 소개하고 있다. 마이크로서비스 아키텍처로 전환하고 현대화된 API 설계를 고심하고 있다면, 이 책의 효과적인 API 설계 방법론과 사례는 좋은 지침이 될 수 있다.

“지난 몇 년 동안 제임스와 함께 일하며 배울 수 있던 것은 내게 행운이었다. 제임스의 실용적인 애플리케이션을 위한 관점과 경험의 깊이에서 오는 다양한 지식은 동료 사이에서도 특별했다. 이제 여러분이 이 책을 통해 더 나은 API를 만드는 방법에 대한 제임스의 강력하고 실용적인 비전을 활용할 기회를 갖게 된 것이 기쁘다. 『웹 API 설계 원칙』은 사용 가능한 기술의 범위를 조사하고 규범적이고 적용하기 쉬운 접근 방식을 제시한다. 이 책의 지침을 적용하는 팀은 고객과 더 잘 소통하고 더 짧은 시간에 더 많은 비즈니스 가치를 제공하며 더 적은 유지 보수가 필요한 API를 만들 것이다. 이 책을 매우 강력하게 추천한다.”
—매튜 레인볼드(Matthew Reinbold)/
포스트맨(Postman)의 API 에코시스템 이사

“제임스는 업계 최고의 API 설계 전문가 중 한 명이며, 이 종합 가이드는 그 사실을 여실히 증명한다. API 설계를 비즈니스 결과 및 디지털 기능의 맥락에서 적용한 이 가이드는 디지털 트랜스포메이션을 겪고 있는 모든 조직에 중요한 지침이 된다.”
—매트 맥라티(Matt McLarty)/
세일즈포스 사 뮬소프트(MuleSoft)의 API 전략 글로벌 리더

“현대 소프트웨어 개발에서 API는 결국 우리가 직면한 많은 문제의 원인이자 해결책이 된다. 개념에서 캐싱에 이르기까지 API를 분해, 분석, 설계하는 제임스의 프로세스는 팀이 생성하는 것보다 더 많은 문제를 해결할 수 있도록 반복 가능한 접근 방식을 제공한다.”
—키이스 케이시(D. Keith Casey, Jr.)/
API Problem Solver, CaseySoftware, LLC

“제임스의 명확하고 따르기 쉬운 가이드에 따라 나는 프로세스를 실제 사용 사례에 적용할 수 있었다. 이를 통해 프로젝트를 수행하는 데 도움이 되는 실용적인 지침, 기술 및 명확한 예를 알게 됐다. API에 연결돼 있고 API로 작업하는 모든 사람에게 권장하는 책이다.”
—조이스 스택(Joyce Stack)/
아키텍트, Elsevier

“이 책은 원칙 그 이상을 보여준다. 독자들은 API를 설계하는 방법인 프로세스를 배우게 될 것이다.”
—아노드 로렛(Arnaud Lauret)/
API Handyman

“이 통찰력 있는 플레이북은 생산적인 협업, 가치 있는 기능 식별 및 모범 사례 작성을 촉진하는 구조화된 프로세스를 통해 API 팀을 안내한다. 제임스는 API 제품을 정의하고 개선하기 위한 실용적인 로드맵으로 수년간의 경험을 정제하고 API 보안, 이벤트, 복원력 및 마이크로서비스 적용에 대한 입문서를 제공한다. API 분야를 처음 접하거나 새로운 팀을 온보딩하고 구조화된 API 정의 프로세스를 도입할 책임이 있는 설계자가 반드시 읽어야 할 책이다.”
—크리스 하다드(Chris Haddad)/
수석 아키텍트(Chief Architect), Karux LLC

◆ 올바른 설계 프로세스를 통해 훌륭한 API 제공
◆ 개발 팀, 고객, 기타 이해관계자로부터 구체적인 결과에 대한 합의 도출
◆ 작업 스토리 작성, EventStorming 수행 및 기능 모델링
◆ 올바른 API를 식별하고 일관된 API 프로파일로 작업을 구성
◆ 각 프로젝트에 가장 적합한 스타일 선택: REST, gRPC, GraphQL 또는 이벤트 기반 비동기 API
◆ 문서 작성자, 테스터, 고객의 피드백을 바탕으로 디자인 개선
◆ API를 마이크로서비스로 분리
◆ 확장 가능한 설계 및 관리 프로세스를 구현해 API 프로그램 완성

인간을 즐겁게 할 단일 API 또는 일련의 API를 설계하려는 모든 사람을 대상으로 한다. 제품 소유자와 제품 관리자는 팀이 API를 설계하는 데 필요한 요소를 더 깊이 이해할 수 있다. 소프트웨어 아키텍트와 개발자는 소프트웨어 아키텍처의 원리를 적용해 API를 설계하는 방법을 배우면 도움이 된다. 테크니컬 라이터는 API 문서의 명확성에 기여할 뿐만 아니라 API 설계 프로세스 전반에 걸쳐 가치를 추가할 수 있는 방법을 식별할 수 있다. 간단히 말해 『웹 API 설계 원칙』은 개발 또는 비개발 역할에 관계없이 API 설계에 관련된 모든 사람을 위한 것이다.

API 설계를 위한 일련의 원칙과 프로세스를 간략하게 설명하는 책이다. 이 책에서 다루는 ADDR 프로세스는 개인 및 여러 팀이 API 설계의 복잡성을 탐색하는 데 도움이 되도록 설계했다. 고객의 소리, 수행해야 할 작업, 프로세스 매핑과 같은 개념을 적용해 API 설계에 대한 객관적인 관점을 갖길 권장한다. 『웹 API 설계의 원칙』은 처음부터 새로운 예시를 통해 안내하지만 기존 API에도 사용될 수 있다.
이 책은 요구 사항 단계에서 고객에게 제공할 준비가 된 API 설계에 도달하는 것까지 API 설계의 모든 측면을 다룬다. 또한 개인, 팀 및 API 소비자 간의 좀 더 효과적인 의사소통을 위해 API 설계를 문서화하는 방법에 대한 지침도 포함돼 있다. 마지막으로 API 설계에 영향을 줄 수 있는 API 전달의 몇 가지 요소를 다룬다.

이 책은 5개의 부로 구성된다.
◆ 1부, ‘웹 API 설계 소개’에서는 API 설계가 중요한 이유에 대한 개요와 이 책에서 사용되는 API 설계 프로세스를 소개한다.
◆ 2부, ‘API 결과에 따른 조정’에서는 API를 설계하는 팀과 모든 고객 및 이해관계자 간의 조정을 보장한다.
◆ 3부, ‘API 후보 정의’에서는 API 프로파일에 원하는 결과를 제공하는 데 필요한 API 작업을 포함해 필요한 API를 식별한다.
◆ 4부, ‘API 설계’에서는 API 프로파일을 대상 개발자의 요구 사항을 충족하는 하나 이상의 API 스타일로 변환한다. 다루는 스타일에는 REST, gRPC, GraphQL, 이벤트 기반 비동기 API가 포함된다.
◆ 5부, ‘API 설계 개선’에서는 문서, 테스트 및 피드백에서 얻은 통찰력을 기반으로 API 설계를 개선한다. 또한 API를 마이크로서비스로 분해하는 장도 포함돼 있다.
마지막으로 이 책은 대규모 조직에서 설계 프로세스를 확장하는 방법에 대한 팁으로 마무리된다.
부록에서는 웹 기반 API에 사용되는 웹 언어인 HTTP에 대한 복습이 필요한 사람들을 위해 시작하는 데 도움이 되는 훌륭한 입문서를 제공한다.

이 책을 쓰기 위한 여정의 시작을 정확히 말하기는 어렵다. 아마도 약 10년 전에 시작됐을 것이다. 수천 시간의 훈련, 수만 마일의 여행, 셀 수 없을 만큼 많은 단어와 코드 라인이 쓰인 결과다. API 여정을 막 시작했거나 이미 모험을 시작한 전 세계 조직의 통찰력으로 구성돼 있다. 이 책에는 내가 만나서 반가웠던 전 세계 API 실무자들의 통찰력이 포함돼 있다.
아니면 내가 소프트웨어 업계에 처음 입문한 거의 25년 전에 여정이 시작됐을 수도 있다. 많은 조언자가 책과 기사를 통해 통찰력을 제공했다. 멘토들은 소프트웨어에 대한 나의 사고방식을 형성하는 데 도움을 줬고, 내가 선호하는 소프트웨어 아키텍처 실현의 토대를 마련해줬다.
이 여행은 거의 40년 전에 할아버지가 나에게 코모도어 64 컴퓨터를 선물했을 때부터 시작됐을 것이다. 할아버지는 토목 기사이자 비용 엔지니어였으며 낮에는 가족을 부양하고자 일하면서 야간 학교에 다녔다. 할아버지는 지식에 목말랐고 모든 것을 읽고 흡수했다. 할아버지는 컴퓨터가 작동하는 것을 보고 “나는 여전히 텔레비전이 어떻게 작동하는지 놀랍다!”라고 말하며 우릴 즐겁게 해줬다. 그러나 할아버지는 “컴퓨터는 언젠가는 중요해질 것이고 내 손자는 컴퓨터를 사용할 줄 알아야 한다.”며 마법의 컴퓨터를 나에게 선물했다. 이 단 한 번의 이벤트로부터 소프트웨어 개발에 대한 내 평생의 사랑이 시작됐다.
실제로 이 여정은 70여 년 전 현재 컴퓨팅 시대의 개척자들이 오늘날 우리가 소프트웨어를 구성하는 데 사용하는 많은 기본 원칙을 확립했을 때 시작됐다. 기술 선택이 바뀌고 트렌드가 바뀌지만 이 모든 것은 소프트웨어 업계와 그 너머에 있는 많은 사람의 작업을 기반으로 한다. 수많은 사람이 오늘날 우리가 하는 일의 길을 개척하는 데 도움을 줬다.
내가 말하고 싶은 것은 API가 역사 속에 있었던 모든 노력 없이는 오늘날의 API가 될 수 없다는 것이다. 따라서 우리는 오늘날 우리가 하는 일의 이면에 있는 ‘어떻게’와 ‘왜’를 더 잘 이해하고자 우리 산업의 역사를 이해하려는 노력이 필요하다. 그런 다음 우리는 이 교훈을 미래의 모든 일에 적용하려고 노력해야 한다. 그 과정에서 우리는 다른 사람들도 그렇게 하도록 영감을 줄 수 있는 방법을 찾아야 한다. 이것이 할아버지와 아버지가 내게 가르친 것이므로 이 교훈을 여러분에게 전하려고 한다. 이 책은 내가 지금까지 여정에서 배운 것들을 반영하고 있다. 다음 세대를 준비하는 동안 여기에 제시된 내용을 바탕으로 새로운 통찰력을 얻길 바란다.

제임스 히긴보텀(James Higginbotham)

25년 이상의 앱 및 API 개발 및 배포 경험을 가진 소프트웨어 개발자이자 설계자다. 기업의 디지털 혁신 여정을 안내하고 제품 기반 사고를 통해 비즈니스와 기술 간의 조정을 보장해 우수한 고객 경험을 제공한다. 팀 및 조직과 협력해 비즈니스, 제품 및 기술 전략을 좀 더 구성 가능한 모듈식 엔터프라이즈 플랫폼으로 조정하는 데 도움을 준다. 또한 기능 간 팀이 ADDR 프로세스를 사용해 API 설계 우선 접근 방식을 적용하는 데 도움이 되는 워크숍을 제공한다. 업계 경험으로는 은행, 상업 보험, 서비스, 여행 그리고 말 그대로 항공사를 착공하게 도운 항공 산업이 포함된다.

IT 업계에 적을 두고 있는 사람으로서 최근만큼 다채로운 주제가 다양한 방식으로 변화를 가져오는 경우가 이제껏 있었나 하는 생각이 든다. 모놀리식(Monolithic)에서 마이크로서비스 아키텍처(MicroService Architecture) 로의 전환은 업계 사람들 사이에서 가장 많이 논의되는 주제 중 하나다. 이미 소개된 많은 책이 이를 대변하고 있다.
바꿔 말하면 이미 많은 책과 글에서 마이크로서비스 아키텍처로 구성된 결과물을 두고 어떤 것이 마이크로서비스 아키텍처이고 왜 하는지를 설명하고 있다. 이 책은 마이크로서비스 아키텍처만을 소개하고자 작성된 책은 아니다. 오히려 설계 관점에서 비즈니스 문제를 어떻게 인식하고 어떠한 절차를 거쳐 API를 설계하는 것이 효과적이고 효율적인지 얘기한다. 그 과정에서 데이터 기반 설계(Data Driven Design) 패턴의 개념이 사용되기도 하고 API 설계의 한 결과로 마이크로서비스의 사례를 소개하기도 한다.
AWS CEO였던 앤디 제시(Andy Jassy)는 언젠가 AWS의 공식 행사에서 연사로 나와 “경험을 압축하는 알고리듬은 없다.”고 말했다. 개인적으로 좋아하는 말이다. 누군가의 경험을 압축해서 내 것으로 만드는 방법은 없다. 하지만 누군가의 경험을 토대로 앞으로 나아갈 방향을 결정하는 데 참고하고 더 밀도 있는 자신만의 경험을 쌓을 수 있다. 현재 애플리케이션의 현대화를 고민 중이라면 이 책은 좋은 지침서가 될 것이다.
—정영민

현대의 서비스에서 API가 얼마나 중요한지는 모두 알고 있다. 이 책은 API 설계를 위한 기술적 구현 방법보다는 프로덕트(비즈니스)에 집중하며 API라는 도구를 통해 어떻게 다양한 관계에 있는 이해관계자들과 목표를 일치시키고 커뮤니케이션할 수 있는지에 대해 초점을 맞추고 있다. 그리고 그 방법을 ADDR 프로세스를 통해 구체적으로 제안하고, 독자가 정확히 이해하고 도입할 수 있도록 자세히 설명하고 있다.
우리는 IT를 이용해 많은 일을 하고 있지만 여전히 사람과 함께 살고 있는 것처럼 이 책은 기술에만 초점을 맞춘 책과는 다른 인사이트를 제공한다. 꼭 개발자가 아니더라도 프로덕트 오너 그리고 기획/운영 팀 등 API를 통해 비즈니스를 하는 조직 내의 누구라도 읽어볼 수 있는 책으로, 조직의 API 설계 지침 기반을 만드는 작업에 유용한 도구가 될 것이다.
—이혁

API는 비즈니스를 운영하는 조직에게 중요한 자산이다. 디지털 전환의 흐름 속에서 IT 업계뿐 아니라 거의 모든 업계에서 API로 구현된 고유의 비즈니스 기능을 자산 관점에서 중요하게 여긴다. 잘 설계된 API는 직면한 비즈니스 문제를 효과적으로 해결하며, 지속적으로 변화하는 비즈니스 환경에서도 적시에 새로운 문제 해결을 위한 기반이 된다. 이 책은 이러한 실질적인 본질을 책 전반에 거쳐 현실적인 사례를 기반으로 전달하고 있다. 중요성을 잘 알면서도 어떻게 적용하는지 막막한 경우가 많다. 비즈니스 영역에 대한 이해와 기술적인 설계 및 고도화를 책 한 권으로 전부 습득할 수는 없을 것이다. 잘 정리된 이론과 저자의 경험, 실질적인 사례를 통해 이 문제 해결 방법을 체득한다면 이제 각자의 고유한 상황과 문제를 대입해서 새로운 성과를 만들 수 있을 것이다.
—김은호

정영민

2010년 삼성전자에서 커리어를 시작해 삼성전자의 삼성페이(Samsung Pay), 빅스비(Bixby) 등 글로벌 스케일 서비스를 클라우드(Cloud) 환경 위에서 설계하고 운영하며, 대규모 서비스의 모니터링 전략, 운영 절차들을 수립했다. 현재는 앞선 경험을 기반으로 AWS에서 엔터프라이즈 고객이 높은 수준의 아키텍처 설계를 선택하고 AWS 서비스를 통해 사용 사례를 구축할 수 있게 지원하는 업무를 담당하고 있다.

이혁

2011년 모바일의 물결과 함께 안드로이드 앱 개발자로 사회생활을 시작했다. 내가 만든 것을 UI를 통해 즉시 볼 수 있고, 다양한 사람들이 사용할 수 있다는 것이 굉장히 큰 매력이었다. 이후 삼성전자의 다양한 글로벌 스케일 서비스에서 DBA로의 삶을 살며 지구상의 다양한 디바이스가 24시간 인터넷을 통해 만들어내는 트래픽을 경험할 수 있었다. 현재는 클라우드의 물결과 함께 AWS에서 솔루션즈 아키텍트(SA, Solutions Architects) 역할을 통해 고객의 비즈니스를 돕고 있다.

김은호

삼성전자 미디어 솔루션 센터에서 프로페셔널 커리어를 시작해 무선 사업부를 거치면서 계속해서 B2C 서비스의 개발 팀에서 경험을 쌓았다. 클라우드 컴퓨팅 기술을 적극적으로 활용해 지속적으로 변화하는 사용자들의 요구와 개발 팀이 구현해내는 아이디어를 안정적으로 빠르게 연결하는 목표를 달성하고자 일했다. 데브옵스(DevOps)와 SRE 등 여러 사례를 소속된 팀에 적용해 성과를 만들고자 노력했다. 이후 AWS의 솔루션즈 아키텍트로 자리를 옮겨 대규모 분산 시스템을 설계하고 운영했던 경험을 바탕으로 여러 도메인의 고객과 함께 주어진 비즈니스 문제 해결을 위해 일했고, 현재는 스타트업 회사인 인텔렉투스의 데이터플랫폼 솔루션 팀에서 다음 성과를 위한 도전을 이어나가고 있다.