발송 그룹 결과 조회 (폴링)
get
/public/v1/messages/{groupId}200알아 둘 것
- 결과는 **폴링으로만** 받습니다 — 웹훅은 제공하지 않습니다.
- `status` 가 COMPLETED·FAILED·CANCELED 중 하나가 되면 더 이상 바뀌지 않습니다. 그 전까지만 폴링하세요.
- 폴링 간격은 5초 이상을 권장합니다. 너무 잦으면 8628(호출 한도)로 막힙니다.
파라미터
요청 본문
이 호출에는 본문이 없습니다.
응답
아래는 200 응답의 실제 모양입니다. 자동 생성된 스펙이 그리는 것은 data 안쪽뿐이라, 그것만 보고 짜면 값을 찾지 못합니다.
- successboolean필수
성공 응답에서는 항상 `true` 입니다.
예: true
- messagestring필수
사람이 읽는 설명. 성공에는 기본 문구가 실리므로 분기 근거로 쓰지 마세요.
예: "Request processed successfully"
- dataPublicGroupResponse필수
요청 결과 본문
- groupIdstring필수
발송 그룹 ID
- messageTypestring필수
채널 코드
ATAIU_FTSMLMMM - statusstring필수
잡 상태
PENDINGSPLITTINGRUNNINGCOMPLETEDFAILEDCANCELED - countsPublicGroupCounts필수
건수 집계
- scheduledAtstring필수null 가능date-time
예약 시각
- startedAtstring필수null 가능date-time
발송 시작 일시
- finishedAtstring필수null 가능date-time
발송 종료 일시
- canceledAtstring필수null 가능date-time
취소 일시 (예약 취소)
- failedReasonstring필수null 가능
실패 사유 · FAILED 만
- timestampstring필수date-time
응답을 만든 시각 (KST)
- methodstring필수
요청 메서드. 요청을 그대로 되비춰 줍니다.
예: "POST"
- pathstring필수
요청 경로
예: "/public/v1/messages/alimtalk"
- correlationIdstring필수
요청 추적 ID. **문의할 때 이 값을 함께 알려 주세요** — 서버 로그를 이 값으로 찾습니다.
에러
실패 응답도 봉투에 담겨 오고, 숫자 code 로 원인이 갈립니다. 이 호출에서 볼 수 있는 코드는 다음과 같습니다.