getMailRequestList

Prev Next

Classic/VPC環境で利用できます。

メール送信リクエストした内訳リストを照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET /mails/requests

リクエストヘッダ

Cloud Outbound Mailer APIで共通して使用されるヘッダの詳細は、Cloud Outbound Mailerのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
startUtc Long Conditional 照会するリクエスト内訳の開始日時
  • 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間を1/1000秒に換算した整数
  • startUtcまたはstartDateTimeのうち1つは必ず入力
  • startDateTimeより優先適用
startDateTime String Conditional 照会するリクエスト内訳の開始日時(UTC+9:00)
  • 使用可能な形式
    • yyyy-MM-dd
    • yyyy-MM-dd HH:mm
    • yyyy-MM-dd HH:mm:ss.SSS
    • yyyy-MM-dd HH:mm:ss SSS
  • startUtcまたはstartDateTimeのうち1つは必ず入力
  • startUtcが優先適用
endUtc Long Conditional 照会するリクエスト内訳の終了日時
  • 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間を1/1000秒に換算した整数
  • endUtcまたはendDateTimeのうち1つは必ず入力
  • endDateTimeより優先適用
endDateTime String Conditional 照会するリクエスト内訳の終了日時(UTC+9:00)
  • 使用可能な形式
    • yyyy-MM-dd
    • yyyy-MM-dd HH:mm
    • yyyy-MM-dd HH:mm:ss.SSS
    • yyyy-MM-dd HH:mm:ss SSS
  • endUtcまたはendDateTimeのうち1つは必ず入力
  • endUtcが優先適用
requestId String Optional リクエスト識別のためのメール送信リクエスト ID
  • 一度に複数件のメール送信をリクエストする場合、requestIdは複数のmailIdを含むことができる
mailId String Optional メール識別用の固有 ID
dispatchType String Optional メール送信をリクエストする際に使用されたツール
  • CONSOLE | API
title String Optional メールの件名
  • like検索をサポート
templateSid Integer Optional メール作成に使用されたテンプレートの SID
senderAddress String Optional 送信者のメールアドレス
recipientAddress String Optional 受信者メールアドレス
sendStatus List<String> Optional メールの送信状態
  • P |R | I | S | F | U | C | PF
    • P: 送信準備中
    • R: 送信準備
    • I: 送信中
    • S: 送信成功
    • F: 送信失敗
    • U: 受信拒否
    • C: 送信取り消し
    • PF: 一部失敗
size Integer Optional ページごとのレコード数
  • 10 (デフォルト)
page Integer Optional 照会対象のページインデックス
  • 0以上
sort String Optional ソート基準
  • createUtc | recipientCount | reservationUtc | sendUtc | statusCode
    • createUtc: 作成日時
    • recipientCount: 受信者数
    • reservationUtc: 送信予約日時
    • sendUtc: 送信完了日時
    • statusCode: 送信状態
  • property(,asc|desc)形式
    • asc (デフォルト)
  • 複数のソート基準を設定可能

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://mail.apigw.ntruss.com/api/v1/mails/requests
?dispatchType=API
&startDateTime=2018-11-01%2000:00
&size=5
&sendStatus=S
&page=0
&endDateTime=2018-11-20%2023:59'
--header 'x-ncp-apigw-timestamp: {Timestamp}'
--header 'x-ncp-iam-access-key: {Access Key}'
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
content List<RequestListResponse> Optional リクエスト内訳リストの詳細
last Boolean Required 最後のページかどうか
totalElements Integer Required 総レコード数
totalPages Integer Required 総ページ数
first Boolean Required 最初のページかどうか
numberOfElements Integer Required 現在ページのレコード数
size Integer Required ページごとのレコード数
number Integer Required 現在ページのインデックス(0からスタート)
sort List<Sort> Required ソート基準

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード 説明
200 - リクエスト成功
400 - 認証失敗、無効なリクエスト
400 77101 ログイン情報エラー
400 77102 リクエストエラー
400 77103 リクエストしたリソースが存在しない
403 77201 リクエストしたリソースに対する権限がない
403 77202 メールサービスの使用を申し込んでいないユーザーが呼び出した場合
405 77001 サポートしないメソッドタイプ
415 77002 サポートしないメディアタイプ
500 - サーバエラー
500 77301 基本プロジェクトが存在しない
500 77302 外部システム API連携エラー
500 77303 その他の内部サーバエラー

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "content":[
    {
      "requestId":"20181120000000000299",
      "requestDate":{
        "utc":1542675575268,
        "formattedDate":"2018-11-20",
        "formattedDateTime":"2018-11-20 09:59:35 268"
      },
      "templateSid":null,
      "templateName":null,
      "emailStatus":{
        "label":"送信成功",
        "code":"S"
      },
      "senderAddress":"no_reply@domain.com",
      "senderName":null,
      "dispatchType":"API",
      "elapsedTime":"00:00:05.230",
      "sendDate":{
        "utc":1542675580498,
        "formattedDate":"2018-11-20",
        "formattedDateTime":"2018-11-20 09:59:40 498"
      },
      "reservationDate":null,
      "requestCount":100,
      "recipientCount":100
    },
    {
      "requestId":"20181113000000000499",
      "requestDate":{
        "utc":1542071645647,
        "formattedDate":"2018-11-13",
        "formattedDateTime":"2018-11-13 10:14:05 647"
      },
      "templateSid":null,
      "templateName":null,
      "emailStatus":{
        "label":"送信成功",
        "code":"S"
      },
      "senderAddress":"a@a.com",
      "senderName":null,
      "dispatchType":"API",
      "elapsedTime":"00:00:00.475",
      "sendDate":{
        "utc":1542071646122,
        "formattedDate":"2018-11-13",
        "formattedDateTime":"2018-11-13 10:14:06 122"
      },
      "reservationDate":null,
      "requestCount":1,
      "recipientCount":1
    },
    {
      "requestId":"20181113000000000299",
      "requestDate":{
        "utc":1542071618910,
        "formattedDate":"2018-11-13",
        "formattedDateTime":"2018-11-13 10:13:38 910"
      },
      "templateSid":null,
      "templateName":null,
      "emailStatus":{
        "label":"送信成功",
        "code":"S"
      },
      "senderAddress":"a@a.com",
      "senderName":null,
      "dispatchType":"API",
      "elapsedTime":"00:00:02.142",
      "sendDate":{
        "utc":1542071621052,
        "formattedDate":"2018-11-13",
        "formattedDateTime":"2018-11-13 10:13:41 052"
      },
      "reservationDate":null,
      "requestCount":1,
      "recipientCount":1
    },
    {
      "requestId":"20181109000063986599",
      "requestDate":{
        "utc":1541752179226,
        "formattedDate":"2018-11-09",
        "formattedDateTime":"2018-11-09 17:29:39 226"
      },
      "templateSid":13,
      "templateName":"test",
      "emailStatus":{
        "label":"送信成功",
        "code":"S"
      },
      "senderAddress":"no_reply@a.com",
      "senderName":"test",
      "dispatchType":"API",
      "elapsedTime":"00:15:02.312",
      "sendDate":{
        "utc":1541753081538,
        "formattedDate":"2018-11-09",
        "formattedDateTime":"2018-11-09 17:44:41 538"
      },
      "reservationDate":null,
      "requestCount":100000,
      "recipientCount":100000
    },
    {
      "requestId":"20181109000063886499",
      "requestDate":{
        "utc":1541752150850,
        "formattedDate":"2018-11-09",
        "formattedDateTime":"2018-11-09 17:29:10 850"
      },
      "templateSid":13,
      "templateName":"test",
      "emailStatus":{
        "label":"送信成功",
        "code":"S"
      },
      "senderAddress":"no_reply@a.com",
      "senderName":"test",
      "dispatchType":"API",
      "elapsedTime":"00:00:17.004",
      "sendDate":{
        "utc":1541752167854,
        "formattedDate":"2018-11-09",
        "formattedDateTime":"2018-11-09 17:29:27 854"
      },
      "reservationDate":null,
      "requestCount":1000,
      "recipientCount":1000
    }
  ],
  "last":false,
  "totalElements":21,
  "totalPages":5,
  "first":true,
  "numberOfElements":5,
  "sort":[
    {
      "direction":"DESC",
      "property":"createUtc",
      "ignoreCase":false,
      "nullHandling":"NATIVE",
      "ascending":false,
      "descending":true
    }
  ],
  "size":5,
  "number":0
}