DirecTalk API 문서
알림톡 · 브랜드 메시지 · 문자를 API 로 보내고 결과를 확인합니다. 모든 요청은 https://api.directalk.io 로 가고, 발급받은 API 키를 Authorization 헤더에 실으면 됩니다.
버전은 경로에 박혀 있습니다 (/public/v1/...). 호환을 깨는 변경은 /v2 로 나가므로, 지금 맞춰 둔 연동이 어느 날 조용히 달라지지 않습니다.
처음이라면
연동은 대개 이 순서로 끝납니다. 각 단계에 필요한 것만 담은 문서로 이어집니다.
- 콘솔에서 API 키를 발급합니다. 허용 IP 대역(CIDR)을 반드시 함께 지정해야 합니다.
- 모의발송으로 요청 모양을 맞춥니다. 과금도 발송도 없습니다.
- 실제로 접수하고, 결과를 폴링해 도달 여부를 확인합니다.
엔드포인트
- post알림톡 발송 접수
/public/v1/messages/alimtalk - post브랜드 메시지 발송 접수준비중
/public/v1/messages/brand - post문자 발송 접수 (문자 스코프 키 필요)준비중
/public/v1/messages/sms - get발송 그룹 결과 조회 (폴링)
/public/v1/messages/{groupId} - get개별 메시지 결과
/public/v1/messages/{groupId}/details - delete예약 취소
/public/v1/messages/{groupId}
가이드
시작하기API 키를 발급받고 첫 요청을 보내기까지. 모의발송으로 안전하게 연동을 맞춰 봅니다.인증 · API 키Bearer 키 전달 방법, 채널 스코프, 허용 IP 대역(CIDR), 국외 IP 차단 정책.응답 봉투와 에러모든 응답을 감싸는 봉투의 모양과 숫자 에러 코드를 읽는 법. 스펙 문서와 실제가 다른 지점입니다.중복 접수 막기타임아웃 뒤 재시도가 같은 메시지를 두 번 보내지 않도록 Idempotency-Key 를 쓰는 법.발송 플로우접수(202) → 폴링 → 건별 결과까지. 접수 성공이 발송 성공이 아닌 이유.템플릿 변수수신자별 값과 공통 값을 템플릿의 #{변수} 자리에 채우는 방법과 우선순위.대체발송알림톡이 도달하지 못했을 때 문자로 대신 보내기. 홀드 포인트가 최고 단가로 잡히는 이유.예약과 취소예약 발송을 걸고 취소하는 법. 취소할 수 있는 시점의 경계.모의발송과금도 발송도 없이 게이트 통과 여부와 예상 비용만 확인합니다. 연동 개발의 출발점.