숨고 팀 블로그 | Tech
숨고 서비스의 경계를 넓히다: 파트너 내재화를 위한 OpenAPI 구축기
AI 엔지니어링 브리핑
숨고는 내부 서비스를 그대로 외부에 공개하지 않고, 파트너의 다양한 요구를 안전하게 받아들이는 전용 OpenAPI 계층을 구축했습니다.
문제 & 배경
외부 요청량 급증이나 파트너 장애가 내부 서비스로 퍼질 수 있고, 내부 API가 숨고의 데이터·인증 방식에 맞춰져 있어 파트너에게 그대로 공개하기 어려웠습니다.
기술 & 해결책
외부 전용 진입점에 IP 화이트리스트와 API Key 인증을 적용하고, 사용자 정보와 토큰을 내부 형식으로 변환했으며, Webhook은 선형 재시도와 설정 중심 구조로 설계해 외부와 내부를 분리하면서 연결했습니다.
교훈 & 주의점
트래픽·인증·데이터를 분리하면 내부 안정성을 지키면서 파트너를 확장할 수 있고, 새로운 연동이 늘어날수록 공통 기능을 표준화하고 설정만으로 확장할 수 있게 만드는 것이 중요합니다.
함께 읽을 글
내용이 비슷해요내용이 비슷한 글을 먼저 보여드려요. 같은 문제나 해결책을 다룬다는 뜻은 아니에요.