Send Email Verification Code API

This document describes how to call the send email verification code API. Before calling the email verification code API, human-machine verification must be completed through the image captcha. For details, see Get Image Captcha.

Request Description

Request Headers

Parameter Name	Name	Required	Type	Description
X-operating-sys-version	Caller operating system version	Yes	String	windows10.1.1
X-device-fingerprint	Caller device fingerprint	Yes	String	156aysdna213sc50
X-device-ip	Caller IP	No	String	192.168.1.2
X-agent	User-Agent information	Yes	String	Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15(KHTML, like Gecko) Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace
X-L	Used for internationalization language setting	No	String	zh
X-client-id	Application authorization ID	Yes	String	nTo1eRIub60vPb54WeE6aojPwYwImtl4

Request Example

{
    "email": "xczczx@bamboocloud.cn",
    "type": "REGISTER_EMS",
    "captcha_token":"71dd26999e314f9abb0c635336976635---{\"x\":237.0,\"y\":5.0}"
}

Request Parameters

Parameter Name	Name	Required	Type	Description
email	Email	Yes	String	Email
type	Sending scenario	Yes	String	Scenario type LOGIN_EMS: Email + verification code login API REGISTER_EMS: Social account registration and binding mobile/email API, Email + verification code registration API MFA_AUTH_EMS: Email + verification code secondary authentication API FORGET_PWD_EMS: Retrieve password by email API CHANGE_PWD_EMS: Force password update by email when expired API, Change password by email API BIND_EMAIL_EMS: Bind mobile/email after social account login API UPDATE_EMAIL_EMS: Update personal email API
captcha_token	Image captcha credential	Yes	String	Token issued after image captcha verification passes. To obtain the captcha, see Get Image Captcha.

Response Example

Success Example

HTTP/1.1 200 OK

Error Example

HTTP/1.1 400 Bad Request

{
    "error_code": "SDK.COMMON.1001",
    "error_msg": "Parameter X-client-id cannot be left blank."
}

Response Parameters

None