X
ID저장

문자싸다

RESTful API

비즈니스 및 앱을 위한 프로페셔널 SMS 문자서비스
쉽고 간단한 API 연동으로 소중한 작업시간과 비용을 줄여드립니다.

연동형 API 신청하기
API Service
고객사 서버
고객사
수신서버
(Relay)
발송 게이트웨이
문자싸다
KT LG U+
이동통신사
단말기
수신자
  1. Request : HTTP TCP/IP 통신을 이용하며 Client는 REST API 규격에 맞춰서 메시지 전송
  2. Response : HTTP Server는 Client로부터 전달 받은 메시지 전송요청 응답
  3. SEND SMS : Server는 통신사에 메시지를 전송
  4. Get Reports : 통신사업자로부터 메시지 리포트 수신
  5. Response Reports : 메시지 리포트 정상 수신 여부에 대한 응답을 Server에 전달

문자보내기 (HMAC 보안 인증)

동일한 내용의 문자를 콤마(,)로 분기하여 동시 1천명에게 전송하실 수 있습니다.
보안 정책: 모든 요청은 HMAC-SHA256 서명을 포함해야 하며, 타임스탬프 오차 5분 이내의 요청만 유효합니다.

[ Request ]
POST /api/send.php HTTP/1.1
Host: api.munjassada.com
Content-Type: application/x-www-form-urlencoded
키 (Parameter) 설명 필수 타입
identifier API 식별자 (ID) O String
sender 발신자 번호 (사전 등록 필수) O String
receiver 수신자 번호 (콤마 구분 최대 1,000명) O String
msg 메시지 내용 (LMS 자동 전환 가능) O String (max 2,000B)
timestamp 현재 Unix 타임스탬프 (UTC) O Integer
nonce 요청 고유 값 (중복 요청 방지) O String
signature HMAC-SHA256 생성 서명 O String (64자)

Signature 생성 규칙

  1. 서명(signature)을 제외한 모든 파라미터를 키(Key) 기준 알파벳 오름차순으로 정렬합니다.
  2. 정렬된 데이터를 key=value&key2=value2... 형식의 Query String으로 만듭니다.
  3. 생성된 문자열을 고유 Secret Key를 사용하여 HMAC-SHA256 해싱합니다.

1. API 서비스 연동 준비 단계 (신청 및 보안 설정)

사용자가 시스템을 통해 메시지를 안전하게 발송하기 위한 필수 보안 및 물리적 설정 단계입니다.

  • 담당자 등록: API 이용 주체를 명확히 합니다. 기술 이슈나 장애 발생 시 긴밀한 소통을 위해 담당자 이름과 연락처를 관리합니다.
  • API 인증 정보 발급 (HMAC):
    - Identifier (식별자): 클라이언트를 구분하는 고유 ID입니다.
    - Secret Key (비밀키): 요청 시 HMAC-SHA256 서명(Signature) 생성에 사용되는 핵심 키입니다. 절대 외부에 노출되지 않도록 주의하십시오.
  • 보안 인증 설정 (Signature & IP):
    - HMAC 서명: 서버 환경(프록시, 로드밸런서 등)에 따라 클라이언트 IP 감지가 어려울 경우를 대비하여, Secret Key 기반의 디지털 서명을 통해 요청의 위변조를 원천 차단합니다.
  • 발신번호 등록: 전기통신사업법에 따라 사전 등록 및 본인 인증이 완료된 번호로만 문자를 보낼 수 있습니다. 미등록 번호 사용 시 인증에 성공하더라도 발송이 차단됩니다.

고객센터

  • 02.2648.0501
  • 평일 : 09시 ~ 18시

    점심 : 12시 ~ 13시 주말,공휴일 휴무

    공지사항

    • 게시물이 없습니다.
  • 회사소개
  • 서비스이용약관
  • 개인정보취급방침
  • 광고/스팸문자 정책
  • 이메일무단수집거부
  • 고객센터