API 문서
서비스 소개콘솔에서 키 발급

가이드

시작하기

  • 시작하기
  • 인증 · API 키

핵심 개념

  • 응답 봉투 · 에러
  • 중복 접수 막기

발송

  • 발송 플로우
  • 템플릿 변수
  • 대체발송
  • 예약 · 취소

운영

  • 모의발송

API 레퍼런스

발송

  • post알림톡 발송
  • post브랜드 메시지 발송
  • post문자 발송

결과 조회

  • get발송 그룹 결과
  • get개별 메시지 결과
  • delete예약 취소

API 레퍼런스

모든 엔드포인트는 https://api.directalk.io 아래에 있고, API 키로 인증합니다. 각 페이지에는 실제 응답 모양(봉투 포함)과 복사해 바로 쓸 수 있는 코드 샘플이 있습니다.

  • post알림톡 발송 접수202
    /public/v1/messages/alimtalkIdempotency-Key 헤더로 중복 접수를 막을 수 있다. 샌드박스 키로 호출하면 과금·실발송 없는 모의발송으로 처리된다 — 응답 모델은 같고 groupId 는 sandbox- 프리픽스의 가짜 값이라 조회·취소할 수 없다.
  • post브랜드 메시지 발송 접수준비중
    /public/v1/messages/brand
  • post문자 발송 접수 (문자 스코프 키 필요)준비중
    /public/v1/messages/sms
  • get발송 그룹 결과 조회 (폴링)200
    /public/v1/messages/{groupId}
  • get개별 메시지 결과200
    /public/v1/messages/{groupId}/details수신번호는 마스킹된다. 커서 페이지네이션.
  • delete예약 취소200
    /public/v1/messages/{groupId}발송 서버 제출 전까지만 가능하다 (6911).