토스페이먼츠, Open API로 결제 생태계를 혁신하다!
by DD
6개월 전
조회수 29
API 설계 시, JSON 포맷과 리소스 중심 설계를 통해 개발 편의성을 높임
개발자 경험 향상을 위해 문서 자동화, 샌드박스, 테스트 환경 등을 제공
API 버저닝을 통해 기존 연동에 영향 없이 지속적인 기능 개선을 지원
API 설계: 개발자 친화적인 인터페이스
토스페이먼츠는 API 설계 시, JSON 포맷을 활용하여 데이터 구조의 일관성을 확보했다. 구체적으로, 관련 정보를 Nested Object로 묶어 중복을 줄이고, 응답의 예측 가능성을 높였다. 따라서 개발자는 직관적으로 API를 이해하고, 연동 시간을 단축할 수 있다.
개발자 경험 극대화를 위한 노력
토스페이먼츠는 개발자 경험을 최우선으로 고려하여 문서 자동화 시스템을 구축했다. 구체적으로, OAS 기반의 문서 자동화를 통해 API 스펙과 문서를 동기화하여 개발자가 최신 정보를 기반으로 개발할 수 있도록 지원한다. 결과적으로, 개발자는 API 연동에 대한 신뢰도를 높일 수 있다.
API 버저닝: 지속 가능한 진화
토스페이먼츠는 API 버저닝을 통해 기존 연동에 영향 없이 API의 지속적인 진화를 가능하게 했다. 따라서, 새로운 기능 추가나 스펙 변경 시에도 기존 가맹점 서비스의 안정성을 보장한다. API 버저닝은 서비스 안정성과 확장성 확보를 위한 핵심 전략이다.
