getMailRequestStatus
    • PDF

    getMailRequestStatus

    • PDF

    記事の要約

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

    送信リクエスト IDを使用して、特定のメールの送信リクエストがどのように処理されたか確認します。

    リクエスト

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

    メソッドURI
    GET/mails/requests/{requestId}/status

    リクエストヘッダ

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

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

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

    フィールドタイプ必須の有無説明
    requestIdStringRequiredリクエスト識別のためのメール送信リクエスト ID
    • 一度に複数件のメール送信をリクエストする場合、requestIdは複数のmailIdを含むことができる

    リクエスト例

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

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

    レスポンス

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

    レスポンスボディ

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

    フィールドタイプ必須の有無説明
    requestIdStringRequiredリクエスト識別のためのメール送信リクエスト ID
    • 一度に複数件のメール送信をリクエストする場合、requestIdは複数のmailIdを含むことができる
    readyCompletedBooleanRequiredリクエスト件数がすべて DBに入力され、送信準備が完了したかどうか
    • true | false
      • true: 送信準備完了(送信完了も含む)
      • false: 送信準備が完了していない
    allSentSuccessBooleanRequiredリクエストされたすべてのメールが送信成功したかどうか
    • true | false
      • true: 成功
      • false: 失敗
    requestCountIntegerRequired送信リクエスト数
    sentCountIntegerRequired送信成功した件数
    finishCountIntegerRequired処理された件数
    • 送信成功、失敗、受信拒否、取り消しを含む
    readyCountIntegerRequired準備完了したか、発送された件数
    • メール送信のために DBに入力された件数
    reservationDateNesDateTimeOptional予約日時
    countsByStatusList<CountByStatus>Required状態別メール件数

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

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

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

    レスポンス例

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

    {
      "requestId":"20181126000000246001",
      "readyCompleted":true,
      "allSentSuccess":false,
      "requestCount":35179,
      "sentCount":33502,
      "finishCount":35179,
      "readyCount":35179,
      "reservationDate":null,
      "countsByStatus":[
        {
          "status":{
            "label":"Failed to send",
            "code":"F"
          },
          "count":1415
        },
        {
          "status":{
            "label":"Sent successfully",
            "code":"S"
          },
          "count":33502
        },
        {
          "status":{
            "label":"Unsubscribe",
            "code":"U"
          },
          "count":262
        }
      ]
    }
    

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

    What's Next
    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.