SDK 개요

SDK는 Communication API를 애플리케이션 코드에서 안정적으로 호출할 수 있도록 제공하는 언어별 클라이언트 라이브러리입니다.

SDK

Java

Java 17+

bizgo-sdk-comm-java

v1.2.0

SDK

Node.js

Node.js 18+ / TypeScript

bizgo-sdk-comm-js

v1.2.0

SDK

Python

Python 3.10+

bizgo-sdk-comm-python

v1.2.0

SDK

Go 1.26+

bizgo-sdk-comm-go

v1.2.0

SDK

PHP

PHP 8.2+

bizgo-sdk-comm-php

v1.2.0

SDK

.NET 8 / .NET Standard 2.0

bizgo-sdk-comm-cs

v1.2.0

지원 언어 및 런타임

모든 SDK는 같은 스펙(bizgo-api-spec, OpenAPI 3.1)에서 생성되며 버전을 함께 올립니다. 현재 최신 버전은 1.2.0입니다.

언어	저장소	패키지	런타임 기준
Java	bizgo-sdk-comm-java	Maven Central `io.github.icomm-api:bizgo-sdk-comm-java`	Java 17 이상
Node.js	bizgo-sdk-comm-js	npm `@bizgo/bizgo-sdk-comm-js`	Node.js 18 이상 (ESM·CommonJS, TypeScript 타입 포함)
Python	bizgo-sdk-comm-python	PyPI `bizgo-sdk-comm`	Python 3.10 이상
Go	bizgo-sdk-comm-go	`github.com/icomm-api/bizgo-sdk-comm-go`	Go 1.26 이상
PHP	bizgo-sdk-comm-php	Composer `icomm-api/bizgo-sdk-comm`	PHP 8.2 이상
C#	bizgo-sdk-comm-cs	NuGet `Bizgo.Sdk.Comm`	.NET 8, .NET Standard 2.0 (.NET Framework 4.6.1 이상)

인증: API KEY. 환경변수 BIZGO_API_KEY에서 읽습니다.
환경: sandbox(실제 발송 없음)와 운영(https://mars.ibapi.kr).
발송: 모든 채널을 통합 발송(/api/omni) 하나로 보내고, 메시지를 여러 개 넣으면 앞 메시지가 실패할 때 다음 메시지로 대체발송합니다.
보내기 전 검증: 필수 필드, 오타 필드, 바이트 길이(SMS 90byte 등, EUC-KR 기준), EUC-KR 범위 밖 문자(이모지), 수신자 200명 제한.
편의 기능: 대량 발송, 클라이언트 속도 제한, 리포트 Polling·Webhook 서명 검증, 테스트 도구, 관측(hooks, OpenTelemetry).

1.2.0은 이전 SDK와 호환되지 않습니다. 버전 번호만 올리면 컴파일되지 않으므로 각 저장소 README의 옮기기 안내를 먼저 확인하세요.

이전	1.2.0
Java 1.1.x 이하 (`net.bizgo.client.BizgoClient`)	`bizgo-sdk-comm-java` 1.2.0
Node.js 1.0.x	`bizgo-sdk-comm-js` 1.2.0
`infobank-omni-sdk-python` (ID/PW 인증)	`bizgo-sdk-comm-python`
`infobank-omni-sdk-go` (ID/PW 인증)	`bizgo-sdk-comm-go`
`infobank-omni-sdk-php5`, `infobank-omni-sdk-php7`	`bizgo-sdk-comm-php` (PHP 8.2 이상)
`Infobank.Omni.Sdk.Cs` (ID/PW 인증)	`bizgo-sdk-comm-cs`