알아야 할 모든 정보, 불필요한 정보는 없습니다.
요청
BroadNet 게이트웨이는 Authorization: Bearer 토큰과 JSON 본문을 포함한 POST 요청을 https://api.broadnet.me/sms/sendSms로 수신합니다. 본문 구성은 senderId(발신자 ID), destinationNumber(국제 형식의 수신번호, 숫자만 입력, + 기호 제외), message(메시지 내용), messageType(GSM-7의 경우 TEXT, 아랍어·이모지 및 기타 비라틴 문자의 경우 UNICODE)입니다. 호출이 성공하면 응답 본문에 메시지 ID와 함께 200 OK가 반환됩니다.
인코딩 및 길이
GSM-7 메시지는 세그먼트당 160자(메시지가 여러 세그먼트로 나뉠 경우 153자)까지 수용 가능합니다. 이모지나 비라틴 문자를 위해 Unicode로 전환하면 70자(장문 문자 시 67자)로 줄어듭니다. 일반 GSM-7의 경우 messageType을 TEXT로, 본문에 Unicode 또는 아랍어가 필요한 경우 UNICODE로 설정하여 문자가 깨지지 않도록 하세요. POST /sms/identify은 발송 전 인코딩 및 세그먼트 수를 반환합니다.
전송 결과를 추측하지 말고 추적하세요
반환된 메시지 ID는 전송 결과 보고(DLR)를 확인하기 위한 핸들입니다. 메시지 제출 시 200 응답을 받는 것을 단말기 수신 증거로 간주하지 마십시오. 웹훅을 설정하여 통신사의 최종 상태(전송 성공, 실패 또는 만료)를 수신하세요.
운영 환경 전환
국제 E.164 번호를 사용하고, 규모를 확장하기 전에 각 대상 국가에 발신자 ID를 등록하며, 일관된 지연 시간을 위해 통신사 직접 연동 경로를 통해 메시지를 발송하세요. 대량 발송 시 동일한 계정으로 SMPP뿐만 아니라 REST를 통해서도 접속할 수 있으므로, HTTP로 시작하여 재등록 절차 없이 바인딩 유형을 전환할 수 있습니다.