Obtaining Verification Code

Updated on 2025-02-10 GMT+08:00

View PDF

Obtain a verification code.

POST /v2/servicerequest/verifycodes/send

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Minimum length: 1 Maximum length: 5000
X-Language	No	String	Specifies the language environment. The value is a common language description character string, for example, zh-cn. It is zh-cn by default. Some internationalization information, such as the service ticket type and name, is displayed based on the language environment. Minimum length: 1 Maximum length: 32
X-Time-Zone	No	String	Specifies the time zone. The value is a common time zone description character string, for example, GMT+8. It is GMT+8 by default. Time-related data is processed based on the time zone of the environment. Minimum length: 1 Maximum length: 32

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
contact_value	Yes	String	Indicates the contact method value. Minimum length: 0 Maximum length: 64
contact_way	Yes	Integer	Indicates the contact method type. The options are 0 (SMS message) and 1 (Email). Minimum value: 0 Maximum value: 1
area_code	Yes	String	Specifies the country/region code. Minimum length: 0 Maximum length: 16

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
error_code	String	Specifies the error code. Minimum length: 0 Maximum length: 32
error_msg	String	Description of the error. Minimum length: 0 Maximum length: 32

{
  "contact_value" : "123456",
  "contact_way" : 1,
  "area_code" : "86"
}

None

Status Code	Description
200	Response of status code 200

Parent topic: Verification Code Management

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel