Java 문자 발송 API 예제

문자 요청 예제 단문(SMS) 전체 코드

예시 값을 실제 발신번호·수신번호·인증키로 바꿔 고객님 서버에서 실행하세요.

SendmClient.java

import com.google.gson.Gson;
import com.google.gson.JsonObject;

import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class SendmClient {

    private static final String API_URL = "https://api.sendm.co.kr/v1/sms/send";

    /* 소스에 직접 쓰지 말고 환경변수나 설정파일에서 읽으세요. */
    private static final String USER_ID = System.getenv("SENDM_USER_ID");
    private static final String API_KEY = System.getenv("SENDM_API_KEY");

    public String sendSms(String callerNo, String receiveNos, String message) throws Exception {

        JsonObject body = new JsonObject();
        body.addProperty("callerNo",   callerNo);     // 등록·승인된 발신번호
        body.addProperty("receiveNos", receiveNos);   // 여러 건은 # 로 구분
        body.addProperty("message",    message);
        // body.addProperty("smsType", "LMS");        // 장문이면 추가
        // body.addProperty("title",   "제목");        // 장문 제목
        // body.addProperty("adYn",    "Y");          // 광고문자면 Y

        byte[] payload = new Gson().toJson(body).getBytes(StandardCharsets.UTF_8);

        HttpURLConnection conn = (HttpURLConnection) new URL(API_URL).openConnection();
        try {
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json; charset=UTF-8");
            conn.setRequestProperty("user-id", USER_ID);
            conn.setRequestProperty("api-key", API_KEY);
            conn.setConnectTimeout(5000);
            conn.setReadTimeout(30000);
            conn.setDoOutput(true);

            try (OutputStream os = conn.getOutputStream()) {
                os.write(payload);
            }

            int status = conn.getResponseCode();

            /* 실패(4xx·5xx)일 때 getInputStream() 을 부르면 IOException 이 난다.
               반드시 getErrorStream() 으로 읽어야 실패 사유를 볼 수 있다. */
            InputStream in = (status == 200) ? conn.getInputStream() : conn.getErrorStream();

            StringBuilder sb = new StringBuilder();
            try (BufferedReader br = new BufferedReader(
                     new InputStreamReader(in, StandardCharsets.UTF_8))) {
                String line;
                while ((line = br.readLine()) != null) {
                    sb.append(line);
                }
            }
            return sb.toString();

        } finally {
            conn.disconnect();
        }
    }
}

호출과 결과 판정

import com.google.gson.JsonObject;
import com.google.gson.JsonParser;

String raw = new SendmClient().sendSms(
        "02-0000-0000",                       // 발신번호
        "010-0000-0001#010-0000-0002",        // 수신번호 (# 구분)
        "주문이 접수되었습니다.");

JsonObject res = JsonParser.parseString(raw).getAsJsonObject();

if ("0".equals(res.get("code").getAsString())) {
    long msgId = res.getAsJsonObject("data").get("msgId").getAsLong();
    // msgId 를 저장해 두면 나중에 발송 결과를 조회할 수 있다
    System.out.println("발송 접수 완료. msgId=" + msgId);
} else {
    System.out.println("발송 실패 [" + res.get("code").getAsString() + "] "
                     + res.get("message").getAsString());
}

code 는 숫자가 아니라 문자열 "0" 입니다. == 0 으로 비교하지 마세요.

다음 단계

• API 신청승인 후 인증키 발급
• API 연동 방법엔드포인트·파라미터 전체
• 발송 실패 원인과 결과코드resultCd 해석
• Python 예제requests로 호출
• Node.js 예제fetch로 호출

최종 업데이트 : 2026년 10월 21일 · 「센드엠 API 연동정의서 v3.1」 기준