SubmitEmailVerification - API Reference| Alibaba Cloud Documentation Center

Description

According to the ICANN policies and regulations, the email address of a domain name owner must be verified. The SubmitEmailVerification API submits email address verification task.

Request parameters

For more information about public request parameters, see Public parameters.

Parameter	Type	Required	Description
Action	String	Yes	API of the action, system required parameter. Set this parameter to SubmitEmailVerification.
Email	String	Yes	Email address. Use commas (,) to separate multiple email addresses.
SendIfExist	Boolean	Yes	Whether to repeatly send the verification email if the verification record already exists
Lang	String	No	Language of the error message returned from the API. The enumerated values include zh (Chinese) and en (English). The default value is en.

Response parameters

Parameter	Type	Description
RequestId	String	Unique request identifier
SuccessList	SendResultType	The success list is sent.
FailList	SendResultType	The failure list is sent.
ExistList	SendResultType	A list already exists.

Error codes

Error code	Description	HTTP status code	Semantics
ParameterIllegal	Parameter illegal.	400	Parameter error
NetworkIOError	Network IO Error.	400	Network I/O exception

Examples

Request example

http://domain-intl.aliyuncs.com/?Action=SubmitEmailVerification
&InstanceId=ST2017120814571100001303
&<Public request parameters>

Response example

XML format

<?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 format

{
  "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"
    }
  ]
}