비즈고 샌드박스와 SDK, 메시지 API 연동 전 테스트 가이드

2026-06-09

메시지 API를 연동하기 전에 개발자가 가장 먼저 확인해야하는 건 테스트 환경이 있는지, 비용은 드는지, SDK는 제공하는지입니다. 비즈고는 샌드박스에서 과금 없이 API 응답 흐름을 검증할 수 있고 SDK로 반복 코드 없이 빠르게 연동할 수 있어요. 이 글에서는 샌드박스 사용법과 제한 사항, SDK 설치와 선택 기준을 정리합니다.

🧪 과금 없이 API를 테스트하는 샌드박스

샌드박스는 실제 메시지를 발송하지 않고 API 요청과 응답 흐름을 확인할 수 있는 테스트 환경이에요. 운영 환경과 동일한 API 규격을 사용하되 Base URI만 샌드박스 주소로 변경하면 됩니다. 과금이 발생하지 않아서 연동 초기에 반복 호출하며 코드를 검증하기 좋습니다. 비즈고 개발자센터(developers.bizgo.io)의 샌드박스 페이지에서 별도 설치 없이 바로 테스트할 수 있어요.

샌드박스에서 할 수 있는 것

비즈고 샌드박스에서는 문자(SMS, LMS, MMS), 카카오톡 알림톡, 브랜드 메시지, 상담톡, 소셜 로그인 등 비즈고에서 제공하는 서비스를 모두 테스트할 수 있습니다. 개발자센터 샌드박스 페이지에서는 두 가지 모드를 제공해요.

FORM 모드: 입력 필드에 값을 채워 바로 API를 호출해볼 수 있습니다. 코드를 작성하기 전에 API 스펙을 빠르게 탐색할 때 유용해요.
JSON 모드: 실제 페이로드 구조를 그대로 확인하며 테스트할 수 있습니다.

비즈고 개발자센터 샌드박스 FORM 모드에서 카카오 알림톡 API를 테스트하는 화면

발송 성공 응답뿐 아니라 실패 응답도 시뮬레이션할 수 있어서 에러 처리 코드를 미리 작성하기 좋습니다. 운영 중에 처음 보는 실패 케이스를 마주치는 일을 줄일 수 있죠.

운영 환경과 샌드박스 환경 비교

항목	운영 환경	샌드박스 환경
Base URI	`mars.ibapi.kr/api/comm`	`sandbox.ibapi.kr/api/comm`
발송	실제 메시지가 발송되며 과금이 발생	실제 발송과 과금 없이 API 응답 흐름만 테스트
API 규격	동일
인증	API Key + IP ACL

✅ 이처럼 환경에 따라 Base URI만 달라질 뿐 API 규격과 인증은 동일해서, 주소 한 줄만 바꾸면 샌드박스에서 검증한 코드를 운영에 그대로 사용할 수 있어요.

샌드박스 테스트 시 주의할 점

샌드박스는 요청 전문 규격과 API 응답 흐름을 사전에 검증하기 위한 환경입니다. 실제 단말기로 메시지가 전송되지 않기 때문에 수신자가 메시지를 실제로 받았는지는 확인할 수 없어요.

카카오톡 알림톡이나 브랜드 메시지의 API 요청 규격은 샌드박스에서 정상적으로 검증할 수 있어요. 다만 카카오 채널 연동이 포함된 전체 흐름을 테스트하려면 운영 환경에서 진행하면 됩니다. 이 서비스들은 발신프로필 키(senderKey)라는 고유 식별값으로 발송 채널을 인증하는데 이 키가 운영 환경에서만 동작하기 때문이에요.

참고로 IP ACL을 등록한 뒤 샌드박스 계정에 반영되기까지 약 1시간정도 소요될 수 있습니다. 등록 직후에 테스트하면 ACL 오류가 발생할 수 있으니 시간을 두고 시도해 보세요.

👉 알림톡 API 연동의 전체 프로세스가 궁금하다면 알림톡 API 연동 가이드를 참고해 보세요.

💻 SDK로 반복 코드 없이 연동하기

샌드박스에서 API 스펙을 확인했다면 다음은 코드를 작성하는 단계입니다. 메시지 API를 직접 HTTP로 호출하면 인증 헤더 구성, 요청 본문 조립, 응답 파싱 같은 코드를 매번 작성해야 하는데 비즈고 SDK를 사용하면 이런 반복 작업을 줄이고 발송 로직에 집중할 수 있어요. 작성한 코드는 샌드박스에서 검증한 뒤 운영 환경으로 전환하면 됩니다.

지원 언어와 설치

비즈고는 Java, Node.js, Python 세 가지 언어의 공식 SDK를 제공합니다. 모두 오픈소스(Apache 2.0 라이선스)이고 GitHub에서 소스코드와 예제를 확인할 수 있어요.

언어	런타임 기준	설치	GitHub
Java	Java 17 이상	Maven Central에서 설치	`bizgo-sdk-comm-java`
Node.js	Node.js / TypeScript 14 이상	npm에서 설치	`bizgo-sdk-comm-js`
Python	Python 3.6 이상	setup.py로 설치	`infobank-omni-sdk-python`

설치 후 메시지를 발송하는 기본 흐름은 세 언어 모두 비슷합니다. Java의 경우 API Key로 클라이언트를 초기화하고 메시지 객체를 만들어 발송 메서드를 호출하면 돼요.

// Java SDK Quick Start 예시

BizgoClient client = BizgoClient.builder()

.apiKey(“YOUR_API_KEY”)

.build();

SmsMessage sms = SmsMessage.builder()

.from(“0316281500”)

.text(“테스트 메시지입니다”)

.build();

OmniRequest request = OmniRequest.builder()

.addMessage(sms)

.addDestination(Destination.builder().to(“01000000000”).build())

.build();

BizgoResponse response = client.send(request);

어떤 SDK를 선택할까

세 SDK 모두 비즈고 통합 메시지 API를 지원하고 대체 발송, 동보 발송, 리포트 조회 같은 핵심 기능을 동일하게 사용할 수 있어요. 개발 환경에 맞춰 선택하면 됩니다.

Java: Spring Boot 기반 백엔드에서 안정적인 서버 연동이 필요할 때 적합합니다. Spring Boot 3.x와 4.x를 모두 지원해요.
Node.js: JavaScript나 TypeScript 환경에서 빠른 개발과 배포가 우선일 때 적합합니다.
Python: 기존 파이썬 운영 환경에 맞추거나 스크립트 기반 자동화를 구성할 때 적합해요.