SubmitEmailVerification:按照ICANN政策规则,域名持有人邮箱必须经过真实性验证,可通过此接口提交Email邮箱验证。

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:SubmitEmailVerification
Email String 邮箱 多个使用逗号(,)分隔。
SendIfExist Boolean 记录已经存在时是否继续发送。
Lang String 接口返回错误信息语言,枚举值范围:zh 中文;en 英文。默认为 en

返回参数

名称 类型 描述
RequestId String 唯一请求识别码。
SuccessList SendResultType 发送成功列表。
FailList SendResultType 发送失败列表。
ExistList SendResultType 已经存在列表。
表 1. SendResultType
名称 类型 描述
Email String 验证邮箱
Code String 返回code
Message String 返回信息

错误码

错误代码 描述 HTTP状态码 语义
ParameterIllegal Parameter illegal. 400 参数错误。
NetworkIOError Network IO Error. 400 网络I/O异常。

示例

请求示例

http://domain.aliyuncs.com/?Action=SubmitEmailVerification
&InstanceId=ST2017120814571100001303
&<公共请求参数>

返回示例

  • XML示例
    <?xml version='1.0' encoding='UTF-8'?>
    <SubmitEmailVerificationResponse>
        <FailList>
            <SendResult>
                <Email>aaa@test.com</Email>
                <Message>The maximum number of attempts allowed to send the email
                    verification link is exceeded.
                </Message>
                <Code>SendTokenQuotaExceeded</Code>
            </SendResult>
        </FailList>
        <RequestId>E2A8A5EF-DF8A-4C48-8FD4-9F6BD71AB26D</RequestId>
        <ExistList />
        <SuccessList>
            <SendResult>
                <Email>ccc@test.com</Email>
                <Message />
                <Code />
            </SendResult>
            <SendResult>
                <Email>ddd@test.com</Email>
                <Message />
                <Code />
            </SendResult>
        </SuccessList>
    </SubmitEmailVerificationResponse>
  • JSON示例
    {
      "existList": [
        {
          "email": "aaa@test.com"
        }
      ],
      "failList": [
        {
          "code": "SendTokenQuotaExceeded",
          "email": "bbb@test.com",
          "message": "The maximum number of attempts allowed to send the email verification link is exceeded."
        }
      ],
      "requestId": "2EF65AFD-A2C4-48D3-B326-ACB52B5A6771",
      "successList": [
        {
          "email": "ccc@test.com"
        },
        {
          "email": "ddd@test.com"
        }
      ]
    }