配信ステータス取得で取得する配信データの処理状態を以下のように定義します。
もくじ
ステータス一覧
表示 | 状態 | 説明 |
なし | 不定 | 配信予約APIを呼び出してから、予約情報が格納されるまでの期間は、ステータスが不定の状態です。 配信ステータス取得APIで情報は取得できません。 |
reserved | 予約済み | 配信予約情報が格納された状態。 |
processing | データ生成中 | 配信用データの生成中。 |
processed | データ生成完了 | 配信用データの生成完了。 |
sending | 配信処理中1 | 配信エンジンへの配信処理中。 以降は配信予約キャンセルはできません。 |
r_sending | 配信処理中2 | 配信エンジンから、送信先メールサーバへ配信処理中。 |
sent | 配信完了 | 送信先メールサーバへの配信が完了。 ※配信予定数の 90% 以上の配信結果が確定した状態 |
failed | 配信失敗 | データ生成および配信処理にて、処理が失敗し配信ができない状態。 |
deleted | 削除 | 配信予約をキャンセルし、予約が削除された状態。 |
ステータス不定状態
配信予約を受付後、即時にリクエストを返却するため、配信予約データの登録処理を、別処理にて実施します。 そのため、情報が登録されるまでの間、配信情報を取得することができません。
予約済み(reserved)
リクエストされた予約データの登録が完了した状態です。予約済みとなりますと、以下の機能の利用が可能となります。
- 配信予約キャンセル
- 配信ステータス取得
配信データ生成中(processing)
配信用データの生成中の状態です。
配信データ生成完了(processed)
配信データの生成が完了した状態となり、配信時刻を待ちます。 即時配信指定の場合は、配信データ生成完了と同時に配信処理の対象となります。
配信処理中1(sending)
配信時刻になり、配信エンジンへ配信処理が開始された状態となります。 多くの予約が同時間に集中した場合、処理待ちが発生する場合があります。 処理待ちなどが発生し、配信処理が時間通りに実施されなかったデータは、配信時刻の1時間後まで再配信処理をおこないます。
配信処理中2(r_sending)
配信エンジンから送信先メールサーバへの配信が開始された状態(配信処理中)となります。
配信完了(sent)
送信先メールサーバへの配信が完了した状態となります。
※配信予定数の 90% 以上の配信結果が確定した状態を意味しており、全ての配信が完了した状態を意味するものではございません。
配信失敗(failed)
配信データ生成および配信処理にて、リトライができない状態となった場合に、配信失敗となります。 この状態を認識するためには、配信ステータス取得APIを利用する必要があります。
削除(deleted)
配信予約をキャンセルし、削除状態にします。