getMail

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

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

リクエスト

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

メソッド	URI
GET	/mails/{mailId}

リクエストヘッダ

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

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

リクエストパスパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`mailId`	String	Required	メール識別用の固有 ID

リクエスト例

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

curl --location --request GET 'https://mail.apigw.ntruss.com/api/v1/mails/20181120000000010999' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

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

レスポンスボディ

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

フィールド	タイプ	必須の有無	説明
`requestId`	String	-	リクエスト識別のためのメール送信リクエスト ID 一度に複数件のメール送信をリクエストする場合、`requestId`は複数の`mailId`を含むことができる
`requesterIp`	String	-	メール送信リクエスタ IPアドレス
`requestDate`	Object	-	リクエスト日時 NesDateTimeを参照
`mailId`	String	-	メール識別用の固有 ID
`title`	String	-	メールの件名
`templateSid`	Integer	-	照会したテンプレートの SID
`templateName`	String	-	照会したテンプレートの名前
`emailStatus`	Object	-	送信状態 EmailStatusを参照
`senderAddress`	String	-	送信者のメールアドレス
`senderName`	String	-	送信者名
`sendDate`	Object	-	送信完了日時 NesDateTimeを参照
`reservationDate`	Object	-	予約日時 NesDateTimeを参照
`body`	String	-	メールの本文
`referencesHeader`	String	-	Referencesヘッダ 0~100個で、<unique_id@domain.com>形式の文字列特定のメールをまとめて見るための固有の値フィールドに値を入力すると、その後に同じ値が入力されたメールだけまとめて照会可能 NAVERメールではメールをまとめて見るために使用値が重複する場合、同じメールスレッドと判断してメールをまとめて表示 Referencesヘッダの最上位値だけで判断
`attachFiles`	List	-	添付ファイルリスト AttachFileを参照
`recipients`	List	-	受信者リスト Recipientを参照
`advertising`	Boolean	-	広告メールかどうか `true` \| `false` `true`: 広告メール `false`: 一般メール

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

Cloud Outbound Mailer APIで共通して使用されるレスポンスステータスコードの詳細は、Cloud Outbound Mailerのレスポンスステータスコードをご参照ください。

レスポンス例

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

{
  "requestId":"20181120000000010999",
  "requesterIp":"10.78.xx.73",
  "requestDate":{
    "utc":1542694793240,
    "formattedDate":"2018-11-20",
    "formattedDateTime":"2018-11-20 15:19:53 240"
  },
  "mailId":"20181120000000011009",
  "title":"test!",
  "templateSid":41,
  "templateName":"test2",
  "emailStatus":{
    "label":"一部失敗",
    "code":"PF"
  },
  "senderAddress":"a@ac.om",
  "senderName":null,
  "sendDate":{
    "utc":1542694793856,
    "formattedDate":"2018-11-20",
    "formattedDateTime":"2018-11-20 15:19:53 856"
  },
  "reservationDate":null,
  "body":"<body>...</body>",
  "referencesHeader":null,
  "attachFiles":[

  ],
  "recipients":[
     {
      "address":"test123456789@ncp-mail.com",
      "name":"",
      "type":{
        "label":"受信者",
        "code":"R"
      },
      "received":false,
      "receivedDate":null,
      "status":{
        "label":"送信失敗",
        "code":"F"
      },
      "retryCount":0,
      "sendResultMessage":"550 5.1.1 No such user 3vir-yOYtA9fRTlWpjkR3 - nsmtp\n",
      "sendResultCode":"RECIPIENT_ADDRESS_ERROR",
      "sendResultCodeMessage":"受信者アドレスエラーにより、送信できません。"
    },
    {
      "address":"test12@ncp-mail.com",
      "name":"",
      "type":{
        "label":"受信者",
        "code":"R"
      },
      "received":false,
      "receivedDate":null,
      "status":{
        "label":"送信成功",
        "code":"S"
      },
      "retryCount":0,
      "sendResultMessage":"Mail sent.",
      "sendResultCode":"MAIL_SENT",
      "sendResultCodeMessage":"メールを送信しました。"
    }
  ],
  "advertising":false
}