발송 결과 폴링
웹훅을 구성하기 어려운 환경이거나, 웹훅 수신에 실패한 건을 보완할 때 사용하는 방식입니다.
미수신 리포트를 배치로 가져와 처리합니다.
웹훅 vs 폴링
| 방식 | 동작 | 권장 상황 |
|---|---|---|
| 웹훅 (Push) | 결과 발생 즉시 서버로 전송 | 기본 권장 방식 |
| 폴링 (Pull) | 주기적으로 API를 호출해 결과 수신 | 웹훅 구성이 어려운 경우, 웹훅 실패 보완 |
폴링 처리 순서
1. 미수신 리포트 조회 (GET)
2. reportId 저장
3. 결과 처리 (DB 저장 등)
4. 수신 확인 처리 (DELETE) ← 반드시 필요
5. 빈 배열이 올 때까지 반복
수신 확인 처리를 하지 않으면 다음 폴링에서 동일한 결과가 반복 수신됩니다.
주요 제약사항
| 항목 | 제한 |
|---|---|
| 1회 최대 수신 건수 | 1,000개 |
| 미처리 리포트 보관 기간 | 3일 (이후 자동 삭제) |
| 수신 확인 처리 | 조회 후 반드시 DELETE 필요 |
다음 단계
- API 스펙 확인 → API 레퍼런스 — 발송 결과 폴링
- 실시간 수신이 필요하다면 → 웹훅 설정하기
- 결과 코드 해석 → 응답 코드 해석