# 중요 메시지를 위한 문자 API — REST 또는 SMPP로 제공

- 표준 URL: https://www.broadnet.me/ko/products/sms-api
- 언어: ko
- 최종 수정일: 2026-10-20
- 발행처: BroadNet (https://www.broadnet.me)
- 렌더링된 페이지를 기반으로 생성된 위 페이지의 Markdown 버전입니다.

문자 API · REST + SMPP

고객의 시간을 존중하는 문자 API.

문자 API를 사용하면 단일 HTTP 요청만으로 인증번호 및 알림과 같은 문자 메시지를 전송할 수 있습니다. BroadNet을 사용하면 코드가 Bearer 토큰으로 POST /sms/sendSms를 호출하거나, 대량 처리 파이프라인을 위해 SMPP로 직접 연동할 수 있습니다. OpenAPI 3.1 사양으로 문서화되어 있으며, 공식 TypeScript SDK를 제공합니다. 전송 결과 보고는 웹훅으로 제공됩니다. 요청 시 테스트 계정 신청이 가능합니다.

[API 연동 계획 수립](https://www.broadnet.me/ko/contact?topic=api-integration&product=sms-api) [테스트 계정 신청 (영문 양식)](https://www.broadnet.me/ko/contact?intent=test-access)

ISO 27001 · 9001 · 22301 GDPR 및 HIPAA 준수 1초 미만의 p99

![전송 경로로 퍼져 나가는 단일 API 통화에 직면한 BroadNet 눈표범](https://www.broadnet.me/marketing/generated/viz-sms-api.png)

라이브 · 단 하나의 API로 모든 채널을

메시징 API

1 API

모든 채널

1,000+

통신사 연동

99.99%

SLA

API 가동 시간

99.99%

월간 SLA 계약, 멀티 리전 지원

API 지연 시간

<350ms

모든 지역 p99 목표

공식 SDK

1

TypeScript / Node.js + OpenAPI 3.1 사양

국가

200+

1,000개 이상의 통신사 직접 연동 경로

하나의 요청 안에서

## POST 요청부터 전송 결과 보고까지의 과정

한 번의 TLS 핸드셰이크, 5단계의 정밀한 홉(hop), 2개의 웹훅. 모든 단계에는 고유한 지연 시간 예산이 할당되어 있으며, 모든 예산은 마케팅 페이지가 아닌 SLA에 명시되어 있습니다.

1. 01 · 요청 귀하의 앱 · REST TLS를 통한 POST /sms/sendSms, Bearer-token 인증, JSON 본문: senderId, destinationNumber, message, messageType. p50 < 41ms TTFB
2. 02 · 에지 BroadNet API 에지 토큰 확인, 스키마 검증 및 경로 조회 — 응답에서 메시지 ID가 즉시 반환됩니다. p50 < 60ms
3. 03 · 라우터 경로 + 대기열 경로별 품질 점수로 가장 빠른 합법 SMPP 바인드를 선택합니다. 멀티 리전 액티브-액티브 페일오버는 800ms 미만. p50 < 10ms
4. 04 · 바인드 통신사 SMPP 3.4 목적지 MNO에 대한 직접 SMPP 바인딩. submit_sm 전송; DLR 상관관계를 위한 시퀀스 번호 추적. p50 < 1.5s
5. 05 · 웹훅 전송 결과 보고 deliver_sm이(가) 전송 결과 보고로서 캡처되어 메시지 ID를 키로 하여 귀하의 웹훅 URL로 POST됩니다. p95 < 2s
6. ← 전송 결과 보고 · 웹훅

01 · 요청

귀하의 앱 · REST

TLS를 통한 POST /sms/sendSms, Bearer-token 인증, JSON 본문: senderId, destinationNumber, message, messageType.

p50 < 41ms TTFB

02 · 에지

BroadNet API 에지

토큰 확인, 스키마 검증 및 경로 조회 — 응답에서 메시지 ID가 즉시 반환됩니다.

p50 < 60ms

03 · 라우터

경로 + 대기열

경로별 품질 점수로 가장 빠른 합법 SMPP 바인드를 선택합니다. 멀티 리전 액티브-액티브 페일오버는 800ms 미만.

p50 < 10ms

04 · 바인드

통신사 SMPP 3.4

목적지 MNO에 대한 직접 SMPP 바인딩. submit_sm 전송; DLR 상관관계를 위한 시퀀스 번호 추적.

p50 < 1.5s

05 · 웹훅

전송 결과 보고

deliver_sm이(가) 전송 결과 보고로서 캡처되어 메시지 ID를 키로 하여 귀하의 웹훅 URL로 POST됩니다.

p95 < 2s

대화형

## API 체험하기

가입 없이 바로 요청을 입력하고 전송을 눌러 시뮬레이션된 응답 및 전송 흐름을 확인하세요 —

POST api.broadnet.me/sms/sendSms

요청

`Authorization: Bearer $BROADNET_TOKEN`

request.sh

```
curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "senderId": "BroadNet",
      "destinationNumber": "447700900123",
      "message": "Your verification code is 482913",
      "messageType": "TEXT"
    }'
```

응답

응답 예시 — 메시지가 전송되지 않음

요청 사항을 입력하고 테스트 계정 신청을 클릭하여 응답 예시를 확인하세요.

브라우저에서 완전히 실행됩니다. 이 페이지를 벗어나는 요청은 없으며 문자가 발송되지도 않습니다.

[Request test access](https://www.broadnet.me/ko/contact?intent=test-access) [전체 API 레퍼런스](https://www.broadnet.me/developers/api)

사용 언어

## 한 번의 호출, 아홉 가지 작성 방식.

모든 탭은 동일한 요청을 전송합니다: Bearer 토큰과 senderId, destinationNumber, message, messageType을 포함한 JSON 본문의 POST /sms/sendSms 요청입니다. 응답 본문은 메시지 ID입니다.

BroadNet은 TypeScript 및 Node.js을 위한 하나의 공식 SDK를 보유하고 있습니다. Node.js, Python, PHP, Java, C#, Go 및 Ruby 탭은 별도의 BroadNet 패키지 설치 없이 일반 HTTP 라이브러리를 사용하여 REST API를 직접 호출합니다.

[전체 API 레퍼런스](https://www.broadnet.me/developers/api#send-sms)

POST · api.broadnet.me/sms/sendSms

Example

```
1curl -X POST https://api.broadnet.me/sms/sendSms \2  -H "Authorization: Bearer $BROADNET_TOKEN" \3  -H "Content-Type: application/json" \4  -d '{5    "senderId": "BroadNet",6    "destinationNumber": "447700900123",7    "message": "Your verification code is 482913",8    "messageType": "TEXT"9  }'10 11# 200 OK → response body is the message ID, e.g. 2603121407537573731
```

프로토콜

## REST 또는 SMPP — 프로토콜 선택

대부분의 팀은 REST를 사용하며 다시는 돌아가지 않습니다. 대량 문자 발송 통신사, 애그리게이터 및 레거시 스택은 SMPP 3.4에 바인드합니다. 동일한 경로, 동일한 SLA, 동일한 대시보드 — 업무에 맞는 인터페이스를 선택하세요.

REST · HTTPS

api.broadnet.me/sms/sendSms

추천

- HTTPS 기반의 JSON, TLS 1.3
- Bearer-token 인증 — BroadNet 계정의 토큰 사용
- POST /sms/sendSms · one path family per channel
- 즉시 또는 예약 발송
- 웹훅으로 전송되는 전송 결과 보고
- /developers/api에서 전체 내용 확인

요청 제한

계정별 고정 제한 없음

최대 페이로드

1 MiB

SMPP 3.4

2775 plain · 계정과 함께 제공되는 TLS 포트

대량

- Binary SMPP v3.4 (요청 시 v5.0 제공)
- Transmitter, Receiver, Transceiver 바인딩
- 계정당 최대 32개의 동시 바인딩
- deliver_sm를 통한 DLR 전달
- TLS 기반 연동, 자격 증명별 IP 허용 목록
- 엔터프라이즈 티어에서 노드당 초당 최대 30,000개 메시지 처리량 제공

노드당

30k SMS/s

페일오버

<800ms

윈도우

100 msg

실제 제공 서비스

## 직접 구축할 필요가 없는 6가지 요소.

### 안전한 재시도

수락된 모든 발송은 메시지 ID를 반환합니다. 네트워크 오류 및 5xx 오류 발생 시 백오프(backoff)를 적용하여 재시도하고, 무분별한 재전송 대신 메시지 ID를 기준으로 전송 결과 보고와 대조하십시오. 이를 통해 백그라운드 워커가 중단되더라도 깔끔하게 복구할 수 있습니다.

### 전송 결과 웹훅

전송 결과 보고는 귀사의 웹훅 URL로 푸시되며 REST 및 SMPP 트래픽 모두 메시지 ID와 연결되므로, 별도의 폴링 루프를 작성할 필요가 없습니다.

### 동시 접속 수

계정당 최대 32개의 병렬 SMPP 바인드 지원. REST 기반 HTTP/2 멀티플렉싱 지원. 계정별 고정 API 속도 제한 없음 — 처리량은 트래픽 규모에 맞춰 조정되며, 연결당 제한이 없습니다.

### 자동 페일오버

멀티 리전 액티브-액티브(Active-Active) 구조입니다. 캠페인 도중 경로 품질이 저하되면 800ms 이내에 다시 바인드하고 처리 중인 메시지를 재큐잉합니다. 직접 SMPP 재연결 로직을 작성할 필요가 없습니다.

### 고정 속도 제한 없음

계정별 고정 API 속도 제한 없음 — 처리량은 트래픽에 맞춰 조정되며, 노드당 초당 30,000 SMS까지 지원합니다. 숨겨진 스로틀링이나 섀도우 밴된 번호 없이, 항상 현재 상태를 알 수 있습니다.

### OpenAPI 3.1 사양

/developers/openapi.yaml.에서 제공되는 기계 판독 가능 형식입니다. 이를 통해 공식 TypeScript SDK가 생성되며, 다른 모든 언어로 클라이언트를 생성하거나 Postman 또는 Insomnia로 가져올 수 있습니다.

고객 사례

## 실제 엔지니어링 팀이 말하는 API

Uber 모빌리티 · 중동·북아프리카 AE SA

과제: 여러 메시징 벤더를 사용하는 스택에서 재시도 폭주 시 중복 OTP가 발생하는 버그가 오랫동안 해결되지 않았습니다. 해결 방법: 단일 발송 경로를 갖춘 BroadNet REST API로 마이그레이션하고, 네트워크 오류 및 5xx 오류 시에만 재시도를 수행하며, API가 반환하는 메시지 ID로 모든 발송을 추적하도록 설계하여 단일 기능 플래그(feature flag)를 통해 배포했습니다.

ID 플랫폼 수석 엔지니어

Samsung 컨슈머 테크 · APAC ID

과제: 다수의 개발자로 구성된 메시징 조직이 릴리스 간 문서화되지 않은 API 변경 사항으로 인해 지속적으로 시간을 낭비했습니다. 접근 방식: OpenAPI 3.1 규격을 계약 기준으로 삼고, 매 릴리스마다 CI에서 타입이 지정된 클라이언트(typed clients)를 재생성합니다.

메시징 플랫폼 스태프 엔지니어

American Express 금융 서비스 · 중동·북아프리카 EG

과제: 부정 사용 방지 팀은 발송 시점과 연결할 수 없는 인바운드 전송 결과 보고를 신뢰할 수 없었습니다. 접근 방식: 모든 전송 결과 보고를 발송 시 반환된 메시지 ID와 매칭하며, 발신자 ID 로테이션을 동일한 흐름 내에서 처리합니다.

사기 및 리스크 담당 엔지니어링 디렉터

1:1

DLR ↔ 메시지 ID

Bearer

모든 호출에 토큰 인증 적용

프로덕션 최적화 설계

## 문서로 보장하는 수치.

이 목표 수치는 단순한 홍보 문구가 아닌 기업용 플랜의 계약 사항입니다. 목표 미달 시 다음 인보이스에 아래의 크레딧이 자동으로 반영됩니다.

API 가동 시간

99.99%

월간 SLA

REST p99 지연 시간

<350ms

모든 지역 대상

웹훅 전송

<2s

p95 엔드 투 엔드

장애 대응

<15 min

24/7 온콜, Severity-1 즉시 확인

서비스 수준 약정

[전체 SLA](https://www.broadnet.me/legal/sla)

월간 API 가동 시간

99.99%

99.99% 미만 시 10% 크레딧 · 99.0% 미만 시 25% · 95.0% 미만 시 50%

REST p50 지연 시간

<100ms

네트워크 이그레스(egress)를 제외한 에지(edge) 단

REST p99 지연 시간

<350ms

모든 지역

웹훅 전송

<2s p95

실패 시 최대 24시간까지 지수 백오프(Exponential backoff) 적용

SMPP 바인드 가용성

99.99%

지역별 제공 및 지역 간 자동 장애 조치(failover)

장애 대응

<15 min

24/7 온콜, Severity-1 즉시 확인

기본적으로 문서화됨

## 전송 결과 보고

공식 TypeScript SDK는 공개 OpenAPI 3.1 명세(spec)를 기반으로 생성되므로 두 데이터가 어긋나는 일이 없습니다. 다른 언어로 클라이언트를 생성하거나 명세를 Postman로 가져올 수 있습니다. 문서는 귀사의 코드와 동일한 스테이징 환경에서 실행됩니다.

[npm · @broadnet/cpaas-sdk 공식 TypeScript SDK 64 API 클래스, 채널 기능별 1개 제공 npm에서 보기](https://www.npmjs.com/package/@broadnet/cpaas-sdk) [broadnet.me/developers/openapi.yaml OpenAPI 3.1 사양 329 8개 채널에 걸친 경로 명세서 다운로드](https://www.broadnet.me/developers/openapi.yaml) [broadnet.me/developers 문서 및 퀵스타트 90s 가입부터 첫 메시지 발송까지 문서 읽어보기](https://www.broadnet.me/ko/developers)

TypeScript SDK Bearer 토큰 인증 broadnet.me/status ngrok 친화적 웹훅

자주 묻는 질문

## 엔지니어링 관련 질문에 직접 답변해 드립니다.

테스트 계정을 신청하시면 영업일 기준 1일 이내에 테스트 자격 증명을 포함하여 회신드립니다. 이후 약 5분 이내에 본인의 인증된 번호로 첫 테스트 문자가 전송됩니다. 운영 트래픽은 통신사 및 규제 기관의 발신자 ID 등록 절차에 따라 결정되며, 일반적으로 영업일 기준 5–15일 이내에 시작됩니다. 이는 BroadNet의 처리 과정이 아닌 규제 기관의 승인 절차에 따른 것입니다.

네트워크 오류 및 5xx 오류 발생 시에만 지수 백오프(exponential backoff) 방식을 적용하여 재시도해야 하며, 수락된 모든 발송에 대해 API가 반환하는 메시지 ID를 유지해야 합니다. 무분별한 재시도 대신 메시지 ID를 기준으로 전송 결과 보고와 대조하여 확인하고, 잔액 부족으로 트래픽이 차단되기 전에 크레딧을 충전하세요.

실제 명세서입니다. /developers/openapi.yaml의 OpenAPI 3.1 명세(/developers/openapi.json의 JSON)는 SMS, WhatsApp, RCS, Telegram, Push, Email, Messenger, Instagram을 포함한 모든 채널을 문서화합니다. 공식 TypeScript SDK(@broadnet/cpaas-sdk)는 이를 기반으로 생성되며, 당사에 문의할 필요 없이 다른 어떤 언어로도 직접 클라이언트를 생성할 수 있습니다.

별도의 API 수수료는 없습니다. 메시지 건수, 국가, 경로별로 요금을 지불합니다. UAE 트랜잭션 메시지는 건당 $0.0123부터 시작하며, KSA는 $0.016, Egypt는 $0.028입니다. SMPP 바인딩은 기업 요금제에 포함되어 있으며, 표준 요금제의 경우 전용 바인딩당 월 $250입니다. 테스트 계정 신청이 가능하며, 테스트 트래픽은 일일 1,000건으로 제한됩니다.

재시도는 30초, 2분, 10분, 30분, 2시간, 8시간, 24시간 간격의 지수 백오프(exponential backoff) 방식으로 24시간 동안 진행됩니다. 각 재시도에는 X-Webhook-Attempt 헤더가 포함됩니다. 24시간이 지나면 이벤트는 데드 레터 큐(DLQ)에 보관되며, 대시보드에서 클릭 한 번으로 조회 및 재전송할 수 있습니다. 표준 티어는 DLQ를 7일 동안, 엔터프라이즈 티어는 90일 동안 유지합니다.

네, 두 서비스는 경로, DLR, 과금 및 대시보드를 공유합니다. 대부분의 고객은 동일한 계정에서 트랜잭션용으로 REST를, 대량 마케팅용으로 SMPP를 사용하며, 두 경로의 전송 결과 보고는 모두 동일한 보고서와 웹훅으로 수집됩니다.

전담 기술 어카운트 매니저 지정, 월 요금에 대한 서비스 크레딧이 적용되는 99.99% API 가동 시간 SLA(99.99% 미만 시 10%, 99.0% 미만 시 25%, 95.0% 미만 시 50%), 15분 이내의 Sev-1 확인이 보장되는 24/7 NOC 페이저, 전용 SMPP 직접 연동, 분기별 아키텍처 리뷰 및 엔지니어링 팀과의 공유 Slack 채널을 제공합니다.

broadnet.me/status에서 구성 요소 상태와 공지된 장애 내역을 확인할 수 있습니다. 해당 페이지는 실시간 모니터링 데이터가 아직 반영되지 않았으므로, 표시된 최근 90일간의 이력은 예시일 뿐 실제 측정값이 아닙니다. 계약상의 가동 시간은 99.99% SLA를 기준으로 합니다.

찾으시는 질문이 없나요? [엔지니어링 팀에 문의하기](https://www.broadnet.me/ko/contact)

SMS API는 다음과 같은 서비스로 연결되는 하나의 진입점입니다 [더 넓은 범위의 A2P SMS 플랫폼](https://www.broadnet.me/ko/products/a2p-sms)하나의 진입점입니다. 동일한 통신사 직접 연동 경로를 통해 [대량 문자 발송 캠페인도 지원합니다](https://www.broadnet.me/ko/products/bulk-sms), [OTP 및 멀티 채널 인증,](https://www.broadnet.me/ko/products/otp)및 [WhatsApp Business API](https://www.broadnet.me/ko/products/whatsapp-business-api).

서비스 제공업체를 비교 중이신가요? 당사의 [2026년 최고의 SMS API](https://www.broadnet.me/ko/compare/best-sms-api-2026) 구매 가이드를 확인해 보세요.

![인피니티 루프 아래 빛나는 빛의 고속도로 위에 있는 BroadNet 눈표범](https://www.broadnet.me/marketing/art/band-products.webp)

통신사급 전송 성능

## 전송 범위: 200개 이상의, 통신사 직접 연동을 통해 86.

그레이 라우트를 사용하지 않습니다. 상업적으로 이용 가능한 경우 통신사 직접 연동을 제공하며, 그렇지 않은 경우 식별 가능한 파트너 관리 경로를 사용합니다. 2003년부터 구축된 네트워크를 통해 모든 채널에 단일 API를 제공합니다.

200+

국가

1,000+

통신사 연동

300M+

일간 메시지 수

[영업팀 문의](https://www.broadnet.me/ko/contact)

테스트 액세스 · 영업일 기준 1일 이내 답변

## 문자 서비스 제공업체와의 갈등을 끝내세요. 지금 시작하세요.

하나의 액세스 토큰, 공식 TypeScript SDK, 그리고 한 화면에 들어오는 빠른 시작 가이드. 가입부터 첫 번째 전송 결과 보고를 받기까지 가장 빠른 경로를 제공합니다.

[API 연동 방법 보기](https://www.broadnet.me/ko/contact?topic=api-integration&product=sms-api) [개발자 온보딩 신청](https://www.broadnet.me/onboarding)

$ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}'

리소스

SMS API 데이터시트

[데이터시트 다운로드· PDF, 101kB](https://www.broadnet.me/resources/datasheets/broadnet-sms-api-datasheet.pdf) [제품 데이터시트](https://www.broadnet.me/resources)

## 관련 가이드 및 답변

이 제품의 핵심 개념에 대해 더 자세히 알아보기.

- [SMS API란 무엇인가요 읽기](https://www.broadnet.me/ko/answers/what-is-sms-api)
- [API를 통해 문자를 어떻게 발송하나요 읽기](https://www.broadnet.me/ko/answers/how-to-send-sms-via-api)
- [SMPP란 무엇인가요 읽기](https://www.broadnet.me/ko/answers/what-is-smpp)
- [A2P SMS란 무엇인가요 읽기](https://www.broadnet.me/ko/answers/what-is-a2p-sms)
- [SMSC란 무엇인가요 읽기](https://www.broadnet.me/ko/answers/what-is-smsc)
- [메시징에서 경로 페일오버(failover)란 무엇인가요 읽기](https://www.broadnet.me/ko/answers/what-is-route-failover)