문자 발송 API 연동 방법

센드엠 API는 어떻게 연동하나요?

제공 엔드포인트

기준 주소는 https://api.sendm.co.kr 입니다.

문자 계열은 /v1, 알림톡 발송·취소와 잔여건수 조회는 /v2 입니다. 경로의 버전을 임의로 바꾸면 동작하지 않습니다.

포토문자 발송 (MMS)

파일을 첨부해야 하므로 JSON이 아니라 multipart/form-data 로 보냅니다.

이미지는 JPG·JPEG·PNG만 받습니다. 1,500×1,440px보다 크면 서버가 비율을 유지해 줄이고 JPG로 변환하며, 변환 후 용량 합계가 1MB를 넘으면 거부합니다(801 여러 장, 802 한 장). 통신사 전달 안정성을 위해 장당 300KB 이하로 보내는 것을 권장합니다. 웹 발송 기준은 SMS·LMS·MMS 차이에서 확인하세요.

최종 결과 조회

잔여 코인·발송 가능 건수

GET /v2/info/coinInfo 는 유형별로 몇 건을 더 보낼 수 있는지 돌려줍니다.

응답 예시

{
  "code": "0",
  "data": {
    "smsCnt": 13181,
    "lmsCnt": 4217,
    "mmsCnt": 1917,
    "atCnt": 13181,
    "totalCoin": 105448
  }
}

발송 결과 조회

발송 시 받은 msgId 로 GET /v1/sms/sendList/{msgId} 를 호출하면 요청 건수와 성공·실패·대기 건수, 그리고 수신자별 결과코드를 확인할 수 있습니다.

예약 발송 취소

GET /v1/sms/cancel/{msgId}(문자) 또는 GET /v2/kakao/cancel/{msgId}(알림톡)를 호출하면 아직 통신사로 넘어가지 않은 발송 대기건(예약 포함)을 실패 처리하고, 해당 건의 코인을 환불합니다. 결과 code 는 0 취소 완료, 99 취소할 정보 없음(없는 msgId·다른 계정 발송 건), 96 이미 발송되었거나 취소할 대기건 없음, 97 취소를 지원하지 않는 발송 경로(고객센터 문의)입니다.

조회 API 요청·응답 필드

발신번호 목록 GET /v1/caller/callerNoList

문자 발송 목록 GET /v1/sms/sendList

잔여 건수(/v2/info/coinInfo)와 발송 상세(/v1/sms/sendList/{msgId}) 필드는 최종 결과 조회에 있습니다. 전체 명세는 /openapi.json(OpenAPI 3.0)으로도 받을 수 있습니다.

제한과 주의

업무별 연동 참고 (주문·예약·인증·대량 공지)

업무마다 쓰는 API와 고객 시스템이 맡을 일을 정리했습니다. 요청·응답 형식은 위 표를 따릅니다.

주문·배송 알림

• 쓰는 APIPOST /v1/sms/send 또는 /v2/kakao/sendAt 로 단계별(접수·출고·배송 완료)로 보냅니다. 결과는 GET /v1/sms/sendList/{msgId}, 알림톡은 /v1/kakao/sendList/{msgId} 로 조회합니다.
• 문자 대체알림톡이 실패했을 때 문자로 대신 보내려면 kakaoList[].reYn=Y 와 reType·reMsg 를 넣습니다.
• 고객 시스템주문번호·단계와 msgId 를 함께 저장합니다. 같은 주문의 같은 단계는 한 번만 보내도록 쇼핑몰 쪽에서 막습니다.
• 취소·반품보내기 전에 주문 상태를 다시 확인합니다. 예약 발송한 알림은 발송 전이면 GET /v1/sms/cancel/{msgId} 로 취소합니다.

예약·방문 안내

• 쓰는 API확정 안내는 바로 보내고, 방문 전 안내는 reserveYn=Y·sendDate(YYYYMMDDHHMM)로 예약 발송합니다.
• 변경예약 발송 내용을 고치는 API는 없습니다. 발송 전이면 GET /v1/sms/cancel/{msgId}(알림톡은 /v2/kakao/cancel/{msgId})로 취소하고 새로 예약합니다. 이미 발송이 시작된 건은 취소할 수 없습니다.
• 고객 시스템예약번호와 msgId 를 함께 저장합니다(취소에 필요). 보내기 직전 예약이 취소·변경되지 않았는지 다시 확인하고, 시간대·휴무 같은 발송 조건도 고객 시스템에서 판단합니다.

회원 인증 메시지

• 쓰는 APIPOST /v1/sms/send 로 인증번호 문자를 보냅니다. GET /v1/sms/sendList/{msgId} 결과는 참고용이며 인증 판정에 쓰지 않습니다.
• 고객 시스템예측할 수 없는 인증번호 발급, 유효시간, 새 번호 발급 시 이전 번호 무효화, 재요청 간격·입력 횟수 제한, 성공 후 재사용 차단을 직접 만듭니다. 센드엠은 이 기능을 제공하지 않습니다.
• 보안인증번호를 로그나 URL에 남기지 않습니다. 같은 번호로 하루에 보낼 수 있는 횟수를 정해 두면 코인 낭비를 막을 수 있습니다.

대량 공지

• 쓰는 APIPOST /v1/sms/send 의 receiveNos 에 수신번호를 # 로 이어 보냅니다. 요청당 수신자 수와 호출 한도는 연동 전에 고객센터로 문의하고, 그 안에서 나눠 요청합니다.
• 결과요청마다 받은 msgId 를 저장하고, GET /v1/sms/sendList/{msgId} 의 list[] 로 수신자별 결과를 모읍니다.
• 재발송실패한 번호만 골라 다시 보냅니다. 전체를 다시 보내면 이미 받은 분께 두 번 갑니다. 코인이 부족하면 발송을 멈추고 GET /v2/info/coinInfo 로 잔액을 확인합니다.
• 예약reserveYn·sendDate 로 예약하고, 발송 전이면 GET /v1/sms/cancel/{msgId} 로 취소합니다.

이어서 보면 좋은 문서

• 개발자 문서 홈준비·예제·검색
• 문자 발송 API 소개연동 범위와 신청 절차
• 발송 실패 원인과 결과코드resultCd 해석과 조치
• 발신번호 등록 방법callerNo 로 쓸 번호 준비
• 요금안내API 발송도 동일 단가

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