getMailRequestList
- 印刷する
- PDF
getMailRequestList
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Classic/VPC環境で利用できます。
メール送信リクエストした内訳リストを照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
GET | /mails/requests |
リクエストヘッダ
Cloud Outbound Mailer APIで共通して使用されるヘッダの詳細は、Cloud Outbound Mailerのリクエストヘッダをご参照ください。
リクエストクエリパラメータ
パラメータの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
startUtc | Long | Conditional | 照会するリクエスト内訳の開始日時
|
startDateTime | String | Conditional | 照会するリクエスト内訳の開始日時(UTC+9:00)
|
endUtc | Long | Conditional | 照会するリクエスト内訳の終了日時
|
endDateTime | String | Conditional | 照会するリクエスト内訳の終了日時(UTC+9:00)
|
requestId | String | Optional | リクエスト識別のためのメール送信リクエスト ID
|
mailId | String | Optional | メール識別用の固有 ID |
dispatchType | String | Optional | メール送信をリクエストする際に使用されたツール
|
title | String | Optional | メールの件名
|
templateSid | Integer | Optional | メール作成に使用されたテンプレートの SID
|
senderAddress | String | Optional | 送信者のメールアドレス |
recipientAddress | String | Optional | 受信者メールアドレス |
sendStatus | List<String> | Optional | メールの送信状態
|
size | Integer | Optional | ページごとのレコード数
|
page | Integer | Optional | 照会対象のページインデックス
|
sort | String | Optional | ソート基準
|
リクエスト例
リクエストのサンプルコードは次の通りです。
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
}
この記事は役に立ちましたか?