토스페이먼츠의 Open API 생태계

토스페이먼츠는 20만 개 이상의 가맹점이 사용하는 Open API를 수십 년간 안정적으로 운영하기 위한 방안을 모색합니다. API는 단순한 통신 수단을 넘어 안정적인 연결 기반으로 인식되며, 잘못 설계된 API는 장기적인 불편과 유지 비용을 초래할 수 있습니다.

이 글에서는 안정성을 제외한 인터페이스, 외부 생태계, 보안, 내부 생태계라는 네 가지 핵심 요소를 중심으로 토스페이먼츠의 Open API 설계 및 관리 방식을 소개합니다. 특히, 인터페이스 설계에서는 리소스 중심의 API 디자인 원칙을 따르며, 경로, 요청, 응답 각 영역에 일관된 가이드라인을 적용하여 개발자가 쉽고 빠르게 이해하며 사용할 수 있도록 '설명하지 않아도 이해되는 API'를 목표로 합니다.

이를 통해 일관성과 예측 가능성을 높여 개발자 경험을 향상시키는 데 중점을 둡니다.