발송 결과 조회

발송 응답으로 받은 receipt_id 로 그 건의 결과를 조회합니다.

GEThttps://message.bootapi.com/alimtalk/messages/{receipt_id}Basic Auth

요청 파라미터

파라미터 타입 필수 설명
receipt_id String 필수 발송 접수 id (경로 파라미터)

코드 예제

curl -X GET "https://message.bootapi.com/alimtalk/messages/68b0f2a1c3d4e5f6a7b8c9d0" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

응답

{
  "receipt_id": "68b0f2a1c3d4e5f6a7b8c9d0",
  "ref_id": "order-20260827-0001",
  "to": "01012345678",
  "template_code": "G_RESTOCK_NOTICE_user",
  "status": "success",
  "error_code": null,
  "error_message": null,
  "reserved_at": null,
  "executed_at": "2026-08-27 10:00:03 +0900",
  "delivered_at": "2026-08-27 10:00:05 +0900"
}json

목록과 같은 카드에서 created_at 만 빠진 형태입니다. 단건·목록·웹훅이 같은 스키마를 쓰므로 파서를 하나로 둘 수 있습니다. 각 필드의 뜻은 발송내역 목록을, 시각 필드 형식은 응답의 시각 형식을 참고합니다.

상태 값 (status)

키 의미
requested 접수됨. 전송 중이거나 예약 대기 중
success 전달됨
failed 실패함. error_code·error_message 를 확인합니다
canceled 예약 취소됨

에러 코드

코드 error_code 메시지 대처 방법
3025 MESSAGE_RECEIPT_NOT_FOUND 발송 기록 없음 receipt_id 가 맞는지, 이 프로젝트의 건인지 확인합니다
ref_id 로도 찾을 수 있습니다

receipt_id 를 저장해 두지 않았다면 발송내역 목록에서 ref_id 로 걸러 찾습니다.

함께 보기