本文へジャンプします。

ニフクラ APIリファレンス

クラウド トップ>API>ESS>GetDeliveryLog

ESS:GetDeliveryLog

概要

配信ログを取得します。

条件を指定すると、その条件に一致するログだけを抽出することができます。
条件は配信期間と配信結果です。
取得するログの件数や混雑状況によって、応答に時間がかかることがあります。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
StartDate 取得対象の期間の開始時間 年月日時分指定(UTC)
  • ※現在より過去90日まで指定可能。
yyyy-MM-ddTHH:mm
例)2017-12-13T00:00
- -  
EndDate 取得対象の期間の終了時間
年月日時分指定(UTC)
  • ※StartDateから24時間未満であること。
yyyy-MM-ddTHH:mm
例)2017-12-13T23:59
- -  
Status 取得したいログのステータスを指定。指定がない場合は全ステータスを取得
1: sent | 2: retry | 3: faild
sent,retry,failedのいずれか一つを指定 - - Statusが指定されない場合はすべてのログを取得。
MaxItems 1ページごとの最大ID数   数値 10000 10000  
NextToken ページ分けに使用するトークン   文字列 - -  

レスポンス

要素名 説明 備考
GetDeliveryLogResponse ルート -  
GetDeliveryLogResult 結果 -  
LogCount 取得したログの件数 -  
Log 1宛先ごとのログの内容 文字列 以下の情報がスペース区切りで記録されます。
配信日 / 配信時間 / 送信結果 / ステータスコード / トランザクションID / 送信元メールアドレス / 宛先メールアドレス / 付加情報
  • ※ステータスコードは、3桁の数字となります。2xxから5xxまでは、SMTPプロトコルにおける応答コードとなります。6xx以降の番号は、独自の応答コードです。応答コードの詳細につきましては、ニフクラ ESSの応答コード一覧をご確認ください。
NextToken 改ページに使用するトークン 文字列  
ResponseMetadata 共通メタ情報 -  

エラー

エラー種別 HTTPステータスコード 説明
MalformedInput 400 クエリ文字列に構文エラーが含まれています。
InvalidParameterValue 400 無効な値または範囲外の値を入力パラメーターに指定しています。
ValidationError 400 パラメーターが不正です。

サンプル

リクエストサンプル
POST / HTTP/1.1
Authorization: NIFTY4-HMAC-SHA256 Credential=<Credential>/east-1/email/nifty4_request, SignedHeaders=host;x-nifty-date, Signature=<Signature>
Host: ess.api.nifcloud.com
X-Nifty-Date: 20170801T014336Z
Content-Length: 116

MaxItems=1&Status=1&EndDate=2017-07-20T23%3A59&Action=GetDeliveryLog&StartDate=2017-07-20T00%3A00&Version=2010-12-01"
レスポンスサンプル
HTTP/1.1 200 OK
Date: Tue, 01 Aug 2017 01:43:37 GMT
Content-Type: text/xml
Content-Length: 757
Connection: close

<GetDeliveryLogResponse>
  <GetDeliveryLogResult>
    <LogCount>1</LogCount>
    <Log>2017-07-20 05:01:59 sent 250 0.08985009239041256 fromaddr@example.com toaddr@example.com 250_Message_received</Log>
    <NextToken>rO0ABXNyADljb20ubmlmdHkuY2xvdWQuZXNzLmFwaS5hY3Rpb24ucGFyYW0uRGVsaXZlcnlMb2dOZXh0VG9rZW5y+2b9GqGp5wIABUoACWxhc3RDb3VudEwAB2VuZERhdGV0ABJMamF2YS9sYW5nL1N0cmluZztMAAhtYXhJdGVtc3EAfgABTAAJc3RhcnREYXRlcQB+AAFMAAZzdGF0dXNxAH4AAXhwAAAAAAAAAAF0ABAyMDE3LTA3LTIwVDIzOjU5dAABMXQAEDIwMTctMDctMjBUMDA6MDB0AAEx</NextToken>
  </GetDeliveryLogResult>
  <ResponseMetadata>
    <RequestId>2481803a-d4f6-4461-a3a9-887e6efe0ff2</RequestId>
  </ResponseMetadata>
</GetDeliveryLogResponse>

推奨画面サイズ 1024×768 以上