getMailRequestList
    • PDF

    getMailRequestList

    • PDF

    記事の要約

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

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

    リクエスト

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

    メソッドURI
    GET/mails/requests

    リクエストヘッダ

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

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

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

    フィールドタイプ必須の有無説明
    startUtcLongConditional照会するリクエスト内訳の開始日時
    • 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間を1/1000秒に換算した整数
    • startUtcまたはstartDateTimeのうち1つは必ず入力
    • startDateTimeより優先適用
    startDateTimeStringConditional照会するリクエスト内訳の開始日時(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が優先適用
    endUtcLongConditional照会するリクエスト内訳の終了日時
    • 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間を1/1000秒に換算した整数
    • endUtcまたはendDateTimeのうち1つは必ず入力
    • endDateTimeより優先適用
    endDateTimeStringConditional照会するリクエスト内訳の終了日時(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が優先適用
    requestIdStringOptionalリクエスト識別のためのメール送信リクエスト ID
    • 一度に複数件のメール送信をリクエストする場合、requestIdは複数のmailIdを含むことができる
    mailIdStringOptionalメール識別用の固有 ID
    dispatchTypeStringOptionalメール送信をリクエストする際に使用されたツール
    • CONSOLE | API
    titleStringOptionalメールの件名
    • like検索をサポート
    templateSidIntegerOptionalメール作成に使用されたテンプレートの SID
    senderAddressStringOptional送信者のメールアドレス
    recipientAddressStringOptional受信者メールアドレス
    sendStatusList<String>Optionalメールの送信状態
    • P |R | I | S | F | U | C | PF
      • P: 送信準備中
      • R: 送信準備
      • I: 送信中
      • S: 送信成功
      • F: 送信失敗
      • U: 受信拒否
      • C: 送信取り消し
      • PF: 一部失敗
    sizeIntegerOptionalページごとのレコード数
    • 10 (デフォルト)
    pageIntegerOptional照会対象のページインデックス
    • 0以上
    sortStringOptionalソート基準
    • 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}'
    

    レスポンス

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

    レスポンスボディ

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

    フィールドタイプ必須の有無説明
    contentList<RequestListResponse>Optionalリクエスト内訳リストの詳細
    lastBooleanRequired最後のページかどうか
    totalElementsIntegerRequired総レコード数
    totalPagesIntegerRequired総ページ数
    firstBooleanRequired最初のページかどうか
    numberOfElementsIntegerRequired現在ページのレコード数
    sizeIntegerRequiredページごとのレコード数
    numberIntegerRequired現在ページのインデックス(0からスタート)
    sortList<Sort>Requiredソート基準

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

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

    HTTPステータスコードコード説明
    200-リクエスト成功
    400-認証失敗、無効なリクエスト
    40077101ログイン情報エラー
    40077102リクエストエラー
    40077103リクエストしたリソースが存在しない
    40377201リクエストしたリソースに対する権限がない
    40377202メールサービスの使用を申し込んでいないユーザーが呼び出した場合
    40577001サポートしないメソッドタイプ
    41577002サポートしないメディアタイプ
    500-サーバエラー
    50077301基本プロジェクトが存在しない
    50077302外部システム API連携エラー
    50077303その他の内部サーバエラー

    レスポンス例

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

    {
      "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
    }
    

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.