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

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SubmitEmailVerification

系统规定参数。取值:SubmitEmailVerification

Email String aaa@test.com

邮箱,多个邮箱使用逗号(,)分隔。

Lang String en

接口返回错误信息语言。取值:

  • zh:中文;
  • en:英文。

默认为en

SendIfExist Boolean false

记录已经存在时是否继续发送。

UserClientIp String 127.0.0.1

用户IP。

返回数据

名称 类型 示例值 描述
ExistList

已经存在列表。

Code String SendTokenQuotaExceeded

返回code。

Email String aaa@test.com

验证邮箱。

Message String The maximum number of attempts allowed to send the email verification link is exceeded.

返回信息。

FailList

发送失败列表。

Code String SendTokenQuotaExceeded

返回code。

Email String bbb@test.com

验证邮箱。

Message String The maximum number of attempts allowed to send the email verification link is exceeded

返回信息。

RequestId String E2A8A5EF-DF8A-4C48-8FD4-9F6BD71AB26D

唯一请求识别码。

SuccessList

发送成功列表。

Code String Success

返回code。

Email String ccc@test.com

验证邮箱。

Message String Success

返回信息。

示例

请求示例


http(s)://[Endpoint]/?Action=SubmitEmailVerification
&Email=aaa@test.com
&<公共请求参数>

正常返回示例

XML 格式

<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></ExistList>
      <SuccessList>
            <SendResult>
                  <Email>ccc@test.com</Email>
                  <Message></Message>
                  <Code></Code>
            </SendResult>
            <SendResult>
                  <Email>ddd@test.com</Email>
                  <Message></Message>
                  <Code></Code>
            </SendResult>
      </SuccessList>
</SubmitEmailVerificationResponse>

JSON 格式

{
	"successList":[
		{
			"email":"ccc@test.com"
		},
		{
			"email":"ddd@test.com"
		}
	],
	"failList":[
		{
			"message":"The maximum number of attempts allowed to send the email verification link is exceeded.",
			"email":"bbb@test.com",
			"code":"SendTokenQuotaExceeded"
		}
	],
	"requestId":"2EF65AFD-A2C4-48D3-B326-ACB52B5A6771",
	"existList":[
		{
			"email":"aaa@test.com"
		}
	]
}

错误码

访问错误中心查看更多错误码。