@alicloud/dytnsapi20200217 3.3.0 → 3.4.0

package/src/client.ts

@@ -11,7 +11,32 @@ export default class Client extends OpenApi {
 
   constructor(config: $OpenApiUtil.Config) {
     super(config);
-    this._endpointRule = "central";
+    this._endpointRule = "regional";
+    this._endpointMap = {
+      'us-west-1': "dytnsapi.aliyuncs.com",
+      'us-east-1': "dytnsapi.aliyuncs.com",
+      'me-east-1': "dytnsapi.aliyuncs.com",
+      'eu-west-1': "dytnsapi.aliyuncs.com",
+      'eu-central-1': "dytnsapi.aliyuncs.com",
+      'cn-zhangjiakou': "dytnsapi.aliyuncs.com",
+      'cn-wulanchabu': "dytnsapi.aliyuncs.com",
+      'cn-shenzhen-finance-1': "dytnsapi.aliyuncs.com",
+      'cn-shenzhen': "dytnsapi.aliyuncs.com",
+      'cn-shanghai-finance-1': "dytnsapi.aliyuncs.com",
+      'cn-shanghai': "dytnsapi.aliyuncs.com",
+      'cn-qingdao': "dytnsapi.aliyuncs.com",
+      'cn-huhehaote': "dytnsapi.aliyuncs.com",
+      'cn-hongkong': "dytnsapi.aliyuncs.com",
+      'cn-hangzhou-finance': "dytnsapi.aliyuncs.com",
+      'cn-hangzhou': "dytnsapi.aliyuncs.com",
+      'cn-chengdu': "dytnsapi.aliyuncs.com",
+      'cn-beijing-finance-1': "dytnsapi.aliyuncs.com",
+      'cn-beijing': "dytnsapi.aliyuncs.com",
+      'ap-southeast-5': "dytnsapi.aliyuncs.com",
+      'ap-southeast-3': "dytnsapi.aliyuncs.com",
+      'ap-southeast-1': "dytnsapi.aliyuncs.com",
+      'ap-northeast-1': "dytnsapi.aliyuncs.com",
+    };
     this.checkConfig(config);
     this._endpoint = this.getEndpoint("dytnsapi", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
   }
@@ -30,7 +55,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 身份证三要素
+   * Three-element (name, ID card number, and ID card photo) verification. Used to compare whether the three pieces of information (the name and ID card number filled in by the user and the uploaded portrait photo) belong to the same user.
+   * 
+   * @remarks
+   * - Before using this API, log on to the Cell Phone Number Service console, go to the Tag Square page, find the corresponding tag, click Apply to Activate, fill in the application materials, and use the tag after the application is approved.
+   * - Before using this API, make sure that you have fully understood the [Cell Phone Number Service pricing](https://help.aliyun.com/document_detail/154751.html).
+   * - Billing applies only when the API return value is Code="OK". Other return results are not billed.
+   * - For the verifiable scope, see [ID Card Three Elements Verification](https://help.aliyun.com/document_detail/2844379.html).
+   * ### QPS limit
+   * - The per-user QPS limit for this API is 200 calls per second. If you exceed the limit, API calls are throttled, which may affect your business. Call the API reasonably.
    * 
    * @param request - CertNoThreeElementVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -89,7 +122,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 身份证三要素
+   * Three-element (name, ID card number, and ID card photo) verification. Used to compare whether the three pieces of information (the name and ID card number filled in by the user and the uploaded portrait photo) belong to the same user.
+   * 
+   * @remarks
+   * - Before using this API, log on to the Cell Phone Number Service console, go to the Tag Square page, find the corresponding tag, click Apply to Activate, fill in the application materials, and use the tag after the application is approved.
+   * - Before using this API, make sure that you have fully understood the [Cell Phone Number Service pricing](https://help.aliyun.com/document_detail/154751.html).
+   * - Billing applies only when the API return value is Code="OK". Other return results are not billed.
+   * - For the verifiable scope, see [ID Card Three Elements Verification](https://help.aliyun.com/document_detail/2844379.html).
+   * ### QPS limit
+   * - The per-user QPS limit for this API is 200 calls per second. If you exceed the limit, API calls are throttled, which may affect your business. Call the API reasonably.
    * 
    * @param request - CertNoThreeElementVerificationRequest
    * @returns CertNoThreeElementVerificationResponse
@@ -100,7 +141,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 身份证二要素认证
+   * Two-element (name and ID card number) verification. Used to verify whether the name and ID card number entered by a user belong to the same person.
+   * 
+   * @remarks
+   * - Before using this operation, make sure that you have fully understood the pricing of Cell Phone Number Service.
+   * - Before using this operation, log on to the Cell Phone Number Service console. On the Tag Marketplace page, find the desired tag, click Apply to Activate, and fill in the application information. You can use the operation only after your application is approved.
+   * - The operation is charged when the response contains Code="OK" and IsConsistent != 2. Other response results are not charged.
+   * ## QPS Limit
+   * The per-user QPS limit of this operation is 200 calls per second. If the limit is exceeded, the API calls are throttled, which may affect your business. Call the operation properly.
    * 
    * @param request - CertNoTwoElementVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -151,7 +199,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 身份证二要素认证
+   * Two-element (name and ID card number) verification. Used to verify whether the name and ID card number entered by a user belong to the same person.
+   * 
+   * @remarks
+   * - Before using this operation, make sure that you have fully understood the pricing of Cell Phone Number Service.
+   * - Before using this operation, log on to the Cell Phone Number Service console. On the Tag Marketplace page, find the desired tag, click Apply to Activate, and fill in the application information. You can use the operation only after your application is approved.
+   * - The operation is charged when the response contains Code="OK" and IsConsistent != 2. Other response results are not charged.
+   * ## QPS Limit
+   * The per-user QPS limit of this operation is 200 calls per second. If the limit is exceeded, the API calls are throttled, which may affect your business. Call the operation properly.
    * 
    * @param request - CertNoTwoElementVerificationRequest
    * @returns CertNoTwoElementVerificationResponse
@@ -162,12 +217,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the enterprise name, the business license number, and the name and ID card of the legal representative belong to the same enterprise. The verification is successful only when the preceding four elements belong to the same enterprise and the business status of the enterprise is Active.
+   * Verifies the enterprise name, enterprise certificate number, enterprise legal person name, and enterprise legal person ID card number. All four items must be consistent and the enterprise\\"s operating status must be active for verification to pass.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the billing of services related to four-element verification for enterprises. For more information, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
-   * *   You are charged only if the value of VerifyResult is true or false and the value of ReasonCode is 0, 1, or 2.
-   * *   Before you call this operation, perform the following operations: Log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC\\&lang=zh). On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you fully understand the billing method and prices of the Enterprise Four-Element Verification product. For billing details, see [Product Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
+   * - Billing applies when VerifyResult returns true/false and ReasonCode is 0, 1, or 2 in the response. Billing does not apply in other cases.
+   * - Before you use this API, log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC&lang=zh), go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply to Activate**, and submit your application. You can use the API after the application is approved.
+   * ### QPS limit
+   * The per-user QPS limit for this API is 200 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call the API appropriately.
    * 
    * @param request - CompanyFourElementsVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -226,12 +283,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the enterprise name, the business license number, and the name and ID card of the legal representative belong to the same enterprise. The verification is successful only when the preceding four elements belong to the same enterprise and the business status of the enterprise is Active.
+   * Verifies the enterprise name, enterprise certificate number, enterprise legal person name, and enterprise legal person ID card number. All four items must be consistent and the enterprise\\"s operating status must be active for verification to pass.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the billing of services related to four-element verification for enterprises. For more information, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
-   * *   You are charged only if the value of VerifyResult is true or false and the value of ReasonCode is 0, 1, or 2.
-   * *   Before you call this operation, perform the following operations: Log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC\\&lang=zh). On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you fully understand the billing method and prices of the Enterprise Four-Element Verification product. For billing details, see [Product Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
+   * - Billing applies when VerifyResult returns true/false and ReasonCode is 0, 1, or 2 in the response. Billing does not apply in other cases.
+   * - Before you use this API, log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC&lang=zh), go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply to Activate**, and submit your application. You can use the API after the application is approved.
+   * ### QPS limit
+   * The per-user QPS limit for this API is 200 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call the API appropriately.
    * 
    * @param request - CompanyFourElementsVerificationRequest
    * @returns CompanyFourElementsVerificationResponse
@@ -242,12 +301,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the enterprise name, the business license number, and the name of the legal representative belong to the same enterprise. The verification is successful only when the three elements belong to the same enterprise and the business status of the enterprise is Active.
+   * Used to verify a company name, company certificate number, and the name of the company\\"s legal representative. Verification passes only when all three are consistent and the company\\"s operating status is in business.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the billing of services related to three-element verification for enterprises. For more information, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
-   * *   You are charged only if the value of VerifyResult is true or false and the value of ReasonCode is 0, 1, or 2.
-   * *   Before you call this operation, perform the following operations: Log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC\\&lang=zh). On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you have fully understood the billing method and pricing of the Three-Element Company Verification product. For billing details, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
+   * - In the returned result, charges apply when VerifyResult is true/false and ReasonCode is 0/1/2. No charges apply in other cases.
+   * - Before you use this API, log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC&lang=zh), go to the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and submit the application materials. You can use the API after the application is approved.
+   * ### QPS limit
+   * The per-user QPS limit for this API is 200 calls per second. Requests that exceed this limit are throttled, which may affect your business. Call this API at a reasonable rate.
    * 
    * @param request - CompanyThreeElementsVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -302,12 +363,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the enterprise name, the business license number, and the name of the legal representative belong to the same enterprise. The verification is successful only when the three elements belong to the same enterprise and the business status of the enterprise is Active.
+   * Used to verify a company name, company certificate number, and the name of the company\\"s legal representative. Verification passes only when all three are consistent and the company\\"s operating status is in business.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the billing of services related to three-element verification for enterprises. For more information, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
-   * *   You are charged only if the value of VerifyResult is true or false and the value of ReasonCode is 0, 1, or 2.
-   * *   Before you call this operation, perform the following operations: Log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC\\&lang=zh). On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you have fully understood the billing method and pricing of the Three-Element Company Verification product. For billing details, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
+   * - In the returned result, charges apply when VerifyResult is true/false and ReasonCode is 0/1/2. No charges apply in other cases.
+   * - Before you use this API, log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC&lang=zh), go to the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and submit the application materials. You can use the API after the application is approved.
+   * ### QPS limit
+   * The per-user QPS limit for this API is 200 calls per second. Requests that exceed this limit are throttled, which may affect your business. Call this API at a reasonable rate.
    * 
    * @param request - CompanyThreeElementsVerificationRequest
    * @returns CompanyThreeElementsVerificationResponse
@@ -318,12 +381,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the enterprise name and the business license number belong to the same enterprise. The verification is successful only when the two elements belong to the same enterprise and the business status of the enterprise is Active.
+   * Used to verify the enterprise name and enterprise certificate number. The name and certificate must be fully consistent, and the enterprise must be in operating status for the verification to pass.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the billing of services related to two-element verification for enterprises. For more information, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
-   * *   You are charged only if the value of VerifyResult is true or false and the value of ReasonCode is 0 or 1.
-   * *   Before you call this operation, perform the following operations: Log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC\\&lang=zh). On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you fully understand the billing methods and pricing of the Enterprise Two-Element Verification product. For billing details, see [Product billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
+   * - Billing applies when Code=OK and ReasonCode=0/1/3 in the returned result. Other cases are not billed.
+   * - Before you use this API, log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC&lang=zh), find the corresponding tag on the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, click **Apply to Activate**, and fill in the application materials. After the application is approved, you can use the API.
+   * ### QPS limit
+   * The single-user QPS limit for this API is 200 times/second. If the limit is exceeded, API calls will be throttled, which may affect your business. Please call the API reasonably.
    * 
    * @param request - CompanyTwoElementsVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -374,12 +439,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the enterprise name and the business license number belong to the same enterprise. The verification is successful only when the two elements belong to the same enterprise and the business status of the enterprise is Active.
+   * Used to verify the enterprise name and enterprise certificate number. The name and certificate must be fully consistent, and the enterprise must be in operating status for the verification to pass.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the billing of services related to two-element verification for enterprises. For more information, see [Billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
-   * *   You are charged only if the value of VerifyResult is true or false and the value of ReasonCode is 0 or 1.
-   * *   Before you call this operation, perform the following operations: Log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC\\&lang=zh). On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you fully understand the billing methods and pricing of the Enterprise Two-Element Verification product. For billing details, see [Product billing](https://help.aliyun.com/document_detail/154751.html?spm=a2c4g.154007.0.0.3edd7eb6E90YT4).
+   * - Billing applies when Code=OK and ReasonCode=0/1/3 in the returned result. Other cases are not billed.
+   * - Before you use this API, log on to the [Cell Phone Number Service console](https://account.aliyun.com/login/login.htm?oauth_callback=https%3A%2F%2Fdytns.console.aliyun.com%2Foverview%3Fspm%3Da2c4g.608385.0.0.79847f8b3awqUC&lang=zh), find the corresponding tag on the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, click **Apply to Activate**, and fill in the application materials. After the application is approved, you can use the API.
+   * ### QPS limit
+   * The single-user QPS limit for this API is 200 times/second. If the limit is exceeded, API calls will be throttled, which may affect your business. Please call the API reasonably.
    * 
    * @param request - CompanyTwoElementsVerificationRequest
    * @returns CompanyTwoElementsVerificationResponse
@@ -390,7 +457,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人删除
+   * Deletes a contact.
+   * 
+   * @remarks
+   * - Make sure you have activated Phone Number Identity Service before calling this operation.
    * 
    * @param request - DeleteContactsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -433,7 +503,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人删除
+   * Deletes a contact.
+   * 
+   * @remarks
+   * - Make sure you have activated Phone Number Identity Service before calling this operation.
    * 
    * @param request - DeleteContactsRequest
    * @returns DeleteContactsResponse
@@ -444,17 +517,17 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Predicts whether a phone number is a nonexistent number by using AI algorithms.
+   * Predicts whether a phone number is invalid by using AI algorithms.
    * 
    * @remarks
-   *   You can call this operation to verify whether a phone number is a nonexistent number. When you call this operation to verify a number, the system charges you CNY 0.01 per verification based on the number of verifications. **Before you call this operation, make sure that you are familiar with the billing of Cell Phone Number Service.**
-   * *   You are charged only if the value of Code is OK and the value of Status is not UNKNOWN.
-   * *   The prediction is not strictly accurate because Cell Phone Number Service predicts the nonexistent number probability by using AI algorithms. The accuracy rate of the prediction and the recall rate of empty numbers are about 95%. **Pay attention to this point when you call this operation**.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
-   * ### [](#)Authorization information
-   * By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - 本接口用于验证号码是否为空号。发起调用该接口验证号码请求时，系统会根据验证次数计费，标准价为0.01元/次。**请确保在使用该接口前，已充分了解本产品的收费方式和价格。**
+   * - 当返回结果中：Code="OK" 且 Status != UNKNOWN 时计费，其他情况不计费。 
+   * - 由于本产品通过AI算法预测手机号的空号概率，所以无法做到100%准确。当前评估的准确率和召回率约为95%左右。**调用时请注意差别**。
+   * - 使用本接口前，请登录号码百科控制台，在[标签广场](https://dytns.console.aliyun.com/analysis/square)页面，找到对应的标签，单击**申请开通**，填写申请资料，审批通过后即可使用。
+   * ### QPS限制
+   * 本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。
+   * ### 授权信息
+   * 默认仅限阿里云账号使用本接口，RAM用户只有在被授予了相关API操作权限后方可使用。具体请参见[为RAM用户授权](https://help.aliyun.com/document_detail/154006.html)。
    * 
    * @param request - DescribeEmptyNumberRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -505,17 +578,17 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Predicts whether a phone number is a nonexistent number by using AI algorithms.
+   * Predicts whether a phone number is invalid by using AI algorithms.
    * 
    * @remarks
-   *   You can call this operation to verify whether a phone number is a nonexistent number. When you call this operation to verify a number, the system charges you CNY 0.01 per verification based on the number of verifications. **Before you call this operation, make sure that you are familiar with the billing of Cell Phone Number Service.**
-   * *   You are charged only if the value of Code is OK and the value of Status is not UNKNOWN.
-   * *   The prediction is not strictly accurate because Cell Phone Number Service predicts the nonexistent number probability by using AI algorithms. The accuracy rate of the prediction and the recall rate of empty numbers are about 95%. **Pay attention to this point when you call this operation**.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
-   * ### [](#)Authorization information
-   * By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - 本接口用于验证号码是否为空号。发起调用该接口验证号码请求时，系统会根据验证次数计费，标准价为0.01元/次。**请确保在使用该接口前，已充分了解本产品的收费方式和价格。**
+   * - 当返回结果中：Code="OK" 且 Status != UNKNOWN 时计费，其他情况不计费。 
+   * - 由于本产品通过AI算法预测手机号的空号概率，所以无法做到100%准确。当前评估的准确率和召回率约为95%左右。**调用时请注意差别**。
+   * - 使用本接口前，请登录号码百科控制台，在[标签广场](https://dytns.console.aliyun.com/analysis/square)页面，找到对应的标签，单击**申请开通**，填写申请资料，审批通过后即可使用。
+   * ### QPS限制
+   * 本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。
+   * ### 授权信息
+   * 默认仅限阿里云账号使用本接口，RAM用户只有在被授予了相关API操作权限后方可使用。具体请参见[为RAM用户授权](https://help.aliyun.com/document_detail/154006.html)。
    * 
    * @param request - DescribeEmptyNumberRequest
    * @returns DescribeEmptyNumberResponse
@@ -588,7 +661,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains the analysis results of a number.
+   * Obtains the result returned by phone number analysis.
+   * 
+   * @remarks
+   * - Before you use this API, log on to the Phone Number Service console, go to the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply to Activate**, fill in the application materials, and then use the API after the application is approved.
+   * - Before you use this API, make sure that you fully understand the [billing](https://help.aliyun.com/document_detail/154008.html) of Phone Number Service.
+   * ### QPS limit
+   * The QPS limit of this API is 1,000 calls per second per user. If the limit is exceeded, API calls are throttled, which may affect your business. Make calls properly.
+   * ### Authorization information
+   * By default, only Alibaba Cloud accounts can use this API. RAM users can use this API only after they are granted the related API operation permissions. For more information, see [Authorize a RAM user](https://help.aliyun.com/document_detail/154006.html).
    * 
    * @param request - DescribePhoneNumberAnalysisRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -647,7 +728,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains the analysis results of a number.
+   * Obtains the result returned by phone number analysis.
+   * 
+   * @remarks
+   * - Before you use this API, log on to the Phone Number Service console, go to the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply to Activate**, fill in the application materials, and then use the API after the application is approved.
+   * - Before you use this API, make sure that you fully understand the [billing](https://help.aliyun.com/document_detail/154008.html) of Phone Number Service.
+   * ### QPS limit
+   * The QPS limit of this API is 1,000 calls per second per user. If the limit is exceeded, API calls are throttled, which may affect your business. Make calls properly.
+   * ### Authorization information
+   * By default, only Alibaba Cloud accounts can use this API. RAM users can use this API only after they are granted the related API operation permissions. For more information, see [Authorize a RAM user](https://help.aliyun.com/document_detail/154006.html).
    * 
    * @param request - DescribePhoneNumberAnalysisRequest
    * @returns DescribePhoneNumberAnalysisResponse
@@ -658,10 +747,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains the analysis results of a phone number.
+   * Get the phone number analysis result.
    * 
    * @remarks
-   * Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the Labels page, find the label that you want to use, click Activate Now, enter the required information, and then submit your application. After your application is approved, you can use the label. Before you call this operation, make sure that you are familiar with the billing of Cell Phone Number Service.
+   * Before using this operation, log on to the Cell Phone Number Service console, go to the Tag Square page, find the corresponding tag, click Apply to activate, and fill in the application materials. You can use the operation after the application is approved.
+   * Make sure that you fully understand the billing of the Cell Phone Number Service before you use this operation.
    * 
    * @param request - DescribePhoneNumberAnalysisAIRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -716,10 +806,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains the analysis results of a phone number.
+   * Get the phone number analysis result.
    * 
    * @remarks
-   * Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the Labels page, find the label that you want to use, click Activate Now, enter the required information, and then submit your application. After your application is approved, you can use the label. Before you call this operation, make sure that you are familiar with the billing of Cell Phone Number Service.
+   * Before using this operation, log on to the Cell Phone Number Service console, go to the Tag Square page, find the corresponding tag, click Apply to activate, and fill in the application materials. You can use the operation after the application is approved.
+   * Make sure that you fully understand the billing of the Cell Phone Number Service before you use this operation.
    * 
    * @param request - DescribePhoneNumberAnalysisAIRequest
    * @returns DescribePhoneNumberAnalysisAIResponse
@@ -862,14 +953,6 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the carrier, registration location, and mobile number portability information of a phone number.
-   * 
-   * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 2,000 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
-   * 
    * @deprecated OpenAPI DescribePhoneNumberAttribute is deprecated, please use Dytnsapi::2020-02-17::DescribePhoneNumberOperatorAttribute instead.
    * 
    * @param request - DescribePhoneNumberAttributeRequest
@@ -913,14 +996,6 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the carrier, registration location, and mobile number portability information of a phone number.
-   * 
-   * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 2,000 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
-   * 
    * @deprecated OpenAPI DescribePhoneNumberAttribute is deprecated, please use Dytnsapi::2020-02-17::DescribePhoneNumberOperatorAttribute instead.
    * 
    * @param request - DescribePhoneNumberAttributeRequest
@@ -933,13 +1008,13 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the usage period of a phone number of a user.
+   * Queries the duration for which a mobile user has been registered on the carrier\\"s network.
    * 
    * @remarks
-   *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 200 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - Before using this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, fill in the application materials, and use the API after the application is approved.
+   * - Make sure that you fully understand the [product pricing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service before using this API.
+   * ### QPS limit
+   * The per-user QPS limit for this API is 200 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call this API at a reasonable rate.
    * 
    * @param request - DescribePhoneNumberOnlineTimeRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -994,13 +1069,13 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the usage period of a phone number of a user.
+   * Queries the duration for which a mobile user has been registered on the carrier\\"s network.
    * 
    * @remarks
-   *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 200 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - Before using this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, fill in the application materials, and use the API after the application is approved.
+   * - Make sure that you fully understand the [product pricing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service before using this API.
+   * ### QPS limit
+   * The per-user QPS limit for this API is 200 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call this API at a reasonable rate.
    * 
    * @param request - DescribePhoneNumberOnlineTimeRequest
    * @returns DescribePhoneNumberOnlineTimeResponse
@@ -1011,13 +1086,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the attribute information about a phone number, including the registration province, registration city, basic carrier (such as China Mobile, China Unicom, China Telecom, or China Broadnet), reseller of mobile communications services (such as Alibaba Communications), mobile number portability, and the number segment to which the phone number belongs.
+   * Queries the carrier information of a phone number, including the province, city, basic carrier (China Mobile, China Unicom, China Telecom, or China Broadnet), mobile virtual network operator (such as Alibaba Cloud Communication), whether the number has been ported, and the number segment.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154008.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   You can call this operation to obtain the carrier, registration location, and mobile number portability information about a phone number. You can query phone numbers in **plaintext** and phone numbers that are encrypted by using **MD5** and **SHA256**.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154008.html) of Cell Phone Number Service.
+   * - By default, only Alibaba Cloud accounts can use this API. RAM users can use this API only after they are granted the required permissions. For more information, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/154006.html).
+   * - This API is used to obtain the current carrier, location, and number portability information of a phone number. The API supports queries for **plaintext**, **MD5**, and **SHA256** encrypted phone numbers.
+   * - Before you use this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and submit the application materials. You can use the API after your application is approved.
+   * ### QPS limit
+   * The QPS limit per user for this API is 2,000 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Make calls reasonably.
    * 
    * @param request - DescribePhoneNumberOperatorAttributeRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1076,13 +1153,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the attribute information about a phone number, including the registration province, registration city, basic carrier (such as China Mobile, China Unicom, China Telecom, or China Broadnet), reseller of mobile communications services (such as Alibaba Communications), mobile number portability, and the number segment to which the phone number belongs.
+   * Queries the carrier information of a phone number, including the province, city, basic carrier (China Mobile, China Unicom, China Telecom, or China Broadnet), mobile virtual network operator (such as Alibaba Cloud Communication), whether the number has been ported, and the number segment.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154008.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   You can call this operation to obtain the carrier, registration location, and mobile number portability information about a phone number. You can query phone numbers in **plaintext** and phone numbers that are encrypted by using **MD5** and **SHA256**.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
+   * - Before you use this API, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154008.html) of Cell Phone Number Service.
+   * - By default, only Alibaba Cloud accounts can use this API. RAM users can use this API only after they are granted the required permissions. For more information, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/154006.html).
+   * - This API is used to obtain the current carrier, location, and number portability information of a phone number. The API supports queries for **plaintext**, **MD5**, and **SHA256** encrypted phone numbers.
+   * - Before you use this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and submit the application materials. You can use the API after your application is approved.
+   * ### QPS limit
+   * The QPS limit per user for this API is 2,000 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Make calls reasonably.
    * 
    * @param request - DescribePhoneNumberOperatorAttributeRequest
    * @returns DescribePhoneNumberOperatorAttributeResponse
@@ -1255,16 +1334,16 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether a phone number is a reassigned phone number by calling this operation.
+   * Quickly verify in a single request if a mobile phone number is a carrier\\"s secondary number assignment.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   You are charged for phone number verifications only if the value of Code is OK and the value of VerifyResult is not 0.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ## [](#qps)QPS limits
-   * You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
-   * ## [](#)Authorization information
-   * By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you use this API, make sure you understand the [pricing](https://help.aliyun.com/document_detail/154751.html) for Phone Number Verification Service.
+   * - You are charged only when the API response returns `Code="OK"` and `VerifyResult` is not `0`. No charge is incurred in any other case.
+   * - Before you use this API, log in to the Phone Number Verification Service console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the tag you need, click **Request Activation**, and complete the application form. You can use the API once your application is approved.
+   * ## QPS limits
+   * The QPS limit is 100 per user. If you exceed this limit, the system throttles your API calls, which may affect your business. Plan your API calls accordingly.
+   * ## Authorization
+   * By default, only an Alibaba Cloud account can call this API. A RAM user must be granted the required permissions to call the API. For more information, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/154006.html).
    * 
    * @param request - DescribePhoneTwiceTelVerifyRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1319,16 +1398,16 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether a phone number is a reassigned phone number by calling this operation.
+   * Quickly verify in a single request if a mobile phone number is a carrier\\"s secondary number assignment.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   You are charged for phone number verifications only if the value of Code is OK and the value of VerifyResult is not 0.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ## [](#qps)QPS limits
-   * You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
-   * ## [](#)Authorization information
-   * By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you use this API, make sure you understand the [pricing](https://help.aliyun.com/document_detail/154751.html) for Phone Number Verification Service.
+   * - You are charged only when the API response returns `Code="OK"` and `VerifyResult` is not `0`. No charge is incurred in any other case.
+   * - Before you use this API, log in to the Phone Number Verification Service console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the tag you need, click **Request Activation**, and complete the application form. You can use the API once your application is approved.
+   * ## QPS limits
+   * The QPS limit is 100 per user. If you exceed this limit, the system throttles your API calls, which may affect your business. Plan your API calls accordingly.
+   * ## Authorization
+   * By default, only an Alibaba Cloud account can call this API. A RAM user must be granted the required permissions to call the API. For more information, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/154006.html).
    * 
    * @param request - DescribePhoneTwiceTelVerifyRequest
    * @returns DescribePhoneTwiceTelVerifyResponse
@@ -1339,7 +1418,97 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains the signature of an authorization token when China Mobile, China Unicom, or China Telecom provides the Uniform Anonymous Identifier (UAID) capability.
+   * This API only provides the signing functionality for acquiring an authorization token during UAID retrieval from the three-network operators.
+   * 
+   * @remarks
+   * This API provides only the **signing function for obtaining an authorization token** as part of the UAID retrieval process for China\\"s three major operators.
+   * - To generate the other parameters required to obtain the authorization token, refer to the respective operator\\"s documentation.
+   * - To request the authorization token, refer to the respective operator\\"s documentation. Note that the request must be sent from the user\\"s mobile device over a cellular network.
+   * - After obtaining the authorization token, call the [UAIDVerification](~~UAIDVerification~~) API to complete the UAID retrieval.
+   * ### How to request an authorization token
+   * >Notice: 
+   * When you request an authorization token, the client or H5 page must be connected to a cellular network.
+   * #### China Mobile (CM)
+   * Protocol: HTTPS + application/json
+   * Method: POST
+   * URL: https\\://msg.cmpassport.com/h5/getMobile
+   * ##### Request parameters
+   * Request example:
+   * `{ "traceId": "mfawsxtcmyplwzpayzzvdvbsowxmkynr", "appId": "300011580392", "sign": "2c61b3c58ffbeed97461e31be4fd931a", "msgId": "redbyxsdetddwaaffajcwwapspykftzx", "expandParams": "", "businessType": "3", "version": "1.0", "timestamp": "20201125101540980" }`
+   * Parameter description:
+   * - `version`: Use `1.0`.
+   * - `timestamp`: The request timestamp, with millisecond precision. This value and its format must match the `Time` input parameter for this API.
+   * - `appId`: Use `300011580392`.
+   * - `businessType`: Use `3`.
+   * - `traceId`: The trace ID. This value must match this API\\"s `OutId` input parameter.
+   * - `sign`: Obtained by calling this API.
+   * - `msgId`: A unique message identifier.
+   * ##### Response parameters
+   * Response example:
+   * `{ "header": { "appId": "300011580392", "msgId": "redbyxsdetddwaaffajcwwapspykftzx", "timestamp": "20201125101607932" }, "body": { "resultCode": "103000", "expandParams": "", "resultDesc": "成功", "token": "H5HTTPS4187AE9743AFCB14F8D99B9D65ED9E01" } }`
+   * Retrieve the `token` from the response `body`.
+   * #### China Unicom (CU)
+   * Obtain the token in two steps.
+   * ##### Step 1: Obtain the authurl
+   * Send a request to the portal server to get the authentication server address (`authurl`).
+   * Protocol: HTTPS + application/json
+   * Method: GET
+   * URL: https\\://nisportal.10010.com:9001/api
+   * ###### Request parameters
+   * Request examples:
+   * JSON request: `?appid=1554778161153`
+   * JSONP request: `?appid=1554778161153&callback=callbackFunction`
+   * Parameter description:
+   * - `appid`: Use 1554778161153.
+   * - `callback`: The name of the JSONP callback function. This parameter is required only for JSONP requests.
+   * ###### Response parameters
+   * Response examples:
+   * JSON response:
+   * `{"authurl": "https://enrichgw.10010.com/d93222629f52ec79"}`
+   * JSONP response:
+   * `callbackFunction({"authurl":"https://enrichgw.10010.com/d93222629f52ec79"})`
+   * Retrieve the `authurl` from the response.
+   * ##### Step 2: Obtain the token
+   * Protocol: HTTPS + application/json
+   * Method: GET
+   * URL: The authurl from Step 1, with /api appended.
+   * Request URL example: `https://enrichgw.10010.com/d93222629f52ec79/api`
+   * ###### Request parameters
+   * Request examples:
+   * JSON request: `?appid=1554778161153`
+   * JSONP request: `?appid=1554778161153&callback=callbackFunction`
+   * Parameter description:
+   * - `appid`: Use 1554778161153.
+   * - `callback`: The name of the JSONP callback function. This parameter is required only for JSONP requests.
+   * ###### Response parameters
+   * Response examples:
+   * JSON response:
+   * `{ "province": "1", "code": "7nHS1nggx2WP613750206700RN6oiRN1" }`
+   * JSONP response:
+   * `callbackFunction({"province":"1","code":"7nHS3Dnkd1BS701851092400RN6oiRN1"})`
+   * Retrieve the `code` from the response.
+   * #### China Telecom (CT)
+   * Protocol: HTTPS + application/x-www-form-urlencoded;charset=UTF-8
+   * Method: GET
+   * URL: https\\://id6.me/gw/preuniq.do
+   * ##### Request parameters
+   * Request example:
+   * `?clientType=30100&appId=9390188202&format=json&sign=D63C166FA19E1996EF********09C6A5397C10B4&paramKey=1D7C25EB8B0B8B4CB3CF8DC60628F6549********786B0AF1FEF93FA1335057A35BF5F0B39A3867EAA9BE14B3898********8B01DE34965060445B6E1F66401D714650E4AB161CD6DCF4A72********3B856F22A192B8B0C39D7A55B961062E68C89C928894F119B25********7C548355FE9DB82852EB93C939F2200B48CD17&paramStr=140********95AF8E138B94754CB4CF83BA6FB********52B258BFDFD38BF233&version=1.1`
+   * Parameter description:
+   * - `appId`: Use `9390188202`.
+   * - `clientType`: The client type. This value must match the `ClientType` input parameter for this API.
+   * - `format`: Use `json` or `jsonp`.
+   * - `version`: Use `1.1`.
+   * - `sign`: Obtained by calling this API.
+   * - `paramKey`: The ciphertext of key A. Key A is a 16-character random string generated by the client. To generate paramKey, encrypt key A using the RSA algorithm and the China Telecom public key. The padding mode is `RSA/ECB/PKCS1Padding`. Download the [China Telecom RSA public key](https://id.189.cn/source/files/API.pem).
+   * - `paramStr`: The ciphertext of a parameter string. This string contains `timeStamp` (a Unix timestamp with millisecond precision, for example `1697791988302`, that corresponds to the value of the `Time` parameter of this API) and `callback` (the name of the JSONP callback function, required only when `format` is set to `jsonp`). To generate `paramStr`, encrypt the string using AES with key A. The padding mode is `AES/CBC/PKCS5Padding`, and the initialization vector is `0000000000000000`.
+   * ##### Response parameters
+   * Response example:
+   * `callback?result=10000&msg=success&data=a35336711c70456cb883f4f224e9a259`
+   * The `data` parameter contains the ciphertext of the business result. To get the result, decrypt the data value using key A, the `AES/CBC/PKCS5Padding` mode, and an initialization vector of `0000000000000000`.
+   * Decrypted business result example:
+   * `{"accessCode": "H5HTTPS4187AE9743AFCB14F8D99B9D65ED9E01"}`
+   * Retrieve the `accessCode` from the decrypted result.
    * 
    * @param request - GetUAIDApplyTokenSignRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1410,7 +1579,97 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains the signature of an authorization token when China Mobile, China Unicom, or China Telecom provides the Uniform Anonymous Identifier (UAID) capability.
+   * This API only provides the signing functionality for acquiring an authorization token during UAID retrieval from the three-network operators.
+   * 
+   * @remarks
+   * This API provides only the **signing function for obtaining an authorization token** as part of the UAID retrieval process for China\\"s three major operators.
+   * - To generate the other parameters required to obtain the authorization token, refer to the respective operator\\"s documentation.
+   * - To request the authorization token, refer to the respective operator\\"s documentation. Note that the request must be sent from the user\\"s mobile device over a cellular network.
+   * - After obtaining the authorization token, call the [UAIDVerification](~~UAIDVerification~~) API to complete the UAID retrieval.
+   * ### How to request an authorization token
+   * >Notice: 
+   * When you request an authorization token, the client or H5 page must be connected to a cellular network.
+   * #### China Mobile (CM)
+   * Protocol: HTTPS + application/json
+   * Method: POST
+   * URL: https\\://msg.cmpassport.com/h5/getMobile
+   * ##### Request parameters
+   * Request example:
+   * `{ "traceId": "mfawsxtcmyplwzpayzzvdvbsowxmkynr", "appId": "300011580392", "sign": "2c61b3c58ffbeed97461e31be4fd931a", "msgId": "redbyxsdetddwaaffajcwwapspykftzx", "expandParams": "", "businessType": "3", "version": "1.0", "timestamp": "20201125101540980" }`
+   * Parameter description:
+   * - `version`: Use `1.0`.
+   * - `timestamp`: The request timestamp, with millisecond precision. This value and its format must match the `Time` input parameter for this API.
+   * - `appId`: Use `300011580392`.
+   * - `businessType`: Use `3`.
+   * - `traceId`: The trace ID. This value must match this API\\"s `OutId` input parameter.
+   * - `sign`: Obtained by calling this API.
+   * - `msgId`: A unique message identifier.
+   * ##### Response parameters
+   * Response example:
+   * `{ "header": { "appId": "300011580392", "msgId": "redbyxsdetddwaaffajcwwapspykftzx", "timestamp": "20201125101607932" }, "body": { "resultCode": "103000", "expandParams": "", "resultDesc": "成功", "token": "H5HTTPS4187AE9743AFCB14F8D99B9D65ED9E01" } }`
+   * Retrieve the `token` from the response `body`.
+   * #### China Unicom (CU)
+   * Obtain the token in two steps.
+   * ##### Step 1: Obtain the authurl
+   * Send a request to the portal server to get the authentication server address (`authurl`).
+   * Protocol: HTTPS + application/json
+   * Method: GET
+   * URL: https\\://nisportal.10010.com:9001/api
+   * ###### Request parameters
+   * Request examples:
+   * JSON request: `?appid=1554778161153`
+   * JSONP request: `?appid=1554778161153&callback=callbackFunction`
+   * Parameter description:
+   * - `appid`: Use 1554778161153.
+   * - `callback`: The name of the JSONP callback function. This parameter is required only for JSONP requests.
+   * ###### Response parameters
+   * Response examples:
+   * JSON response:
+   * `{"authurl": "https://enrichgw.10010.com/d93222629f52ec79"}`
+   * JSONP response:
+   * `callbackFunction({"authurl":"https://enrichgw.10010.com/d93222629f52ec79"})`
+   * Retrieve the `authurl` from the response.
+   * ##### Step 2: Obtain the token
+   * Protocol: HTTPS + application/json
+   * Method: GET
+   * URL: The authurl from Step 1, with /api appended.
+   * Request URL example: `https://enrichgw.10010.com/d93222629f52ec79/api`
+   * ###### Request parameters
+   * Request examples:
+   * JSON request: `?appid=1554778161153`
+   * JSONP request: `?appid=1554778161153&callback=callbackFunction`
+   * Parameter description:
+   * - `appid`: Use 1554778161153.
+   * - `callback`: The name of the JSONP callback function. This parameter is required only for JSONP requests.
+   * ###### Response parameters
+   * Response examples:
+   * JSON response:
+   * `{ "province": "1", "code": "7nHS1nggx2WP613750206700RN6oiRN1" }`
+   * JSONP response:
+   * `callbackFunction({"province":"1","code":"7nHS3Dnkd1BS701851092400RN6oiRN1"})`
+   * Retrieve the `code` from the response.
+   * #### China Telecom (CT)
+   * Protocol: HTTPS + application/x-www-form-urlencoded;charset=UTF-8
+   * Method: GET
+   * URL: https\\://id6.me/gw/preuniq.do
+   * ##### Request parameters
+   * Request example:
+   * `?clientType=30100&appId=9390188202&format=json&sign=D63C166FA19E1996EF********09C6A5397C10B4&paramKey=1D7C25EB8B0B8B4CB3CF8DC60628F6549********786B0AF1FEF93FA1335057A35BF5F0B39A3867EAA9BE14B3898********8B01DE34965060445B6E1F66401D714650E4AB161CD6DCF4A72********3B856F22A192B8B0C39D7A55B961062E68C89C928894F119B25********7C548355FE9DB82852EB93C939F2200B48CD17&paramStr=140********95AF8E138B94754CB4CF83BA6FB********52B258BFDFD38BF233&version=1.1`
+   * Parameter description:
+   * - `appId`: Use `9390188202`.
+   * - `clientType`: The client type. This value must match the `ClientType` input parameter for this API.
+   * - `format`: Use `json` or `jsonp`.
+   * - `version`: Use `1.1`.
+   * - `sign`: Obtained by calling this API.
+   * - `paramKey`: The ciphertext of key A. Key A is a 16-character random string generated by the client. To generate paramKey, encrypt key A using the RSA algorithm and the China Telecom public key. The padding mode is `RSA/ECB/PKCS1Padding`. Download the [China Telecom RSA public key](https://id.189.cn/source/files/API.pem).
+   * - `paramStr`: The ciphertext of a parameter string. This string contains `timeStamp` (a Unix timestamp with millisecond precision, for example `1697791988302`, that corresponds to the value of the `Time` parameter of this API) and `callback` (the name of the JSONP callback function, required only when `format` is set to `jsonp`). To generate `paramStr`, encrypt the string using AES with key A. The padding mode is `AES/CBC/PKCS5Padding`, and the initialization vector is `0000000000000000`.
+   * ##### Response parameters
+   * Response example:
+   * `callback?result=10000&msg=success&data=a35336711c70456cb883f4f224e9a259`
+   * The `data` parameter contains the ciphertext of the business result. To get the result, decrypt the data value using key A, the `AES/CBC/PKCS5Padding` mode, and an initialization vector of `0000000000000000`.
+   * Decrypted business result example:
+   * `{"accessCode": "H5HTTPS4187AE9743AFCB14F8D99B9D65ED9E01"}`
+   * Retrieve the `accessCode` from the decrypted result.
    * 
    * @param request - GetUAIDApplyTokenSignRequest
    * @returns GetUAIDApplyTokenSignResponse
@@ -1503,7 +1762,17 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 历史三要素
+   * Verifies whether a name, phone number, and ID number belonged to the same user at a specific point in time.
+   * 
+   * @remarks
+   * ## Usage notes
+   * - Before you use this API, ensure you understand its [pricing](https://help.aliyun.com/zh/cpns/product-overview/pricing-of-cpns).
+   * - Before you use this API, log on to the Phone Number Intelligence console and apply for the required tag on the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page.
+   * - You are charged for a call only when the response returns `Code=\\"OK\\"` and `IsConsistent != 0`. No charges are incurred for any other results.
+   * - Verification of China Broadcasting Network numbers (numbers with the 192 prefix) is not supported. If you provide a number with the 192 prefix, an HTTP 400 error is returned.
+   * - Due to number portability, the actual carrier may differ from the current carrier of record. You can use the `Carrier` parameter to route the query to a specific carrier.
+   * - The queries per second (QPS) limit per user is 200. Requests that exceed this limit are throttled.
+   * - In the authorization information, the action is `dytns:HistoryThreeElementsVerification`, the access level is Read, and the resource type is All Resources.
    * 
    * @param request - HistoryThreeElementsVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1558,7 +1827,17 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 历史三要素
+   * Verifies whether a name, phone number, and ID number belonged to the same user at a specific point in time.
+   * 
+   * @remarks
+   * ## Usage notes
+   * - Before you use this API, ensure you understand its [pricing](https://help.aliyun.com/zh/cpns/product-overview/pricing-of-cpns).
+   * - Before you use this API, log on to the Phone Number Intelligence console and apply for the required tag on the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page.
+   * - You are charged for a call only when the response returns `Code=\\"OK\\"` and `IsConsistent != 0`. No charges are incurred for any other results.
+   * - Verification of China Broadcasting Network numbers (numbers with the 192 prefix) is not supported. If you provide a number with the 192 prefix, an HTTP 400 error is returned.
+   * - Due to number portability, the actual carrier may differ from the current carrier of record. You can use the `Carrier` parameter to route the query to a specific carrier.
+   * - The queries per second (QPS) limit per user is 200. Requests that exceed this limit are throttled.
+   * - In the authorization information, the action is `dytns:HistoryThreeElementsVerification`, the access level is Read, and the resource type is All Resources.
    * 
    * @param request - HistoryThreeElementsVerificationRequest
    * @returns HistoryThreeElementsVerificationResponse
@@ -1569,12 +1848,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Filters invalid phone numbers.
+   * Performs invalid phone number filtering operations.
    * 
    * @remarks
-   * Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 1,000 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * Before you call this operation, log on to the Cell Phone Number Service console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and submit the application materials. You can use this operation after the application is approved.
+   * ### QPS limit
+   * The QPS limit per user for this operation is 1,000 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call the operation at a reasonable frequency.
    * 
    * @param request - InvalidPhoneNumberFilterRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1625,12 +1904,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Filters invalid phone numbers.
+   * Performs invalid phone number filtering operations.
    * 
    * @remarks
-   * Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 1,000 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * Before you call this operation, log on to the Cell Phone Number Service console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and submit the application materials. You can use this operation after the application is approved.
+   * ### QPS limit
+   * The QPS limit per user for this operation is 1,000 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call the operation at a reasonable frequency.
    * 
    * @param request - InvalidPhoneNumberFilterRequest
    * @returns InvalidPhoneNumberFilterResponse
@@ -1641,7 +1920,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人查询
+   * Lists the alert contacts for Number Encyclopedia.
+   * 
+   * @remarks
+   * - Before using this API, ensure that you have activated Number Encyclopedia.
    * 
    * @param request - ListContactsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1688,7 +1970,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人查询
+   * Lists the alert contacts for Number Encyclopedia.
+   * 
+   * @remarks
+   * - Before using this API, ensure that you have activated Number Encyclopedia.
    * 
    * @param request - ListContactsRequest
    * @returns ListContactsResponse
@@ -1757,12 +2042,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Encrypts the original phone number into a virtual number that starts with 140. Cell Phone Number Service integrates the communications services provided by Alibaba Cloud. This allows you to initiate a call by using a virtual number that starts with 140.
+   * Encrypts an original phone number into a virtual phone number that starts with 140. By integrating with Alibaba Cloud communication services, you can use the encrypted 140 phone number to initiate voice calls, achieving the effect of a virtual phone number call.
    * 
    * @remarks
-   * Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 1,000 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * Before you use this API, log on to the Cell Phone Number Service console, go to the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and fill in the application materials. You can use this API after the application is approved.
+   * ### QPS limit
+   * The per-user QPS limit of this API is 1,000 calls per second. If the number of API calls exceeds the limit, the calls will be throttled, which may affect your business. Call the API properly.
    * 
    * @param request - PhoneNumberEncryptRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1817,12 +2102,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Encrypts the original phone number into a virtual number that starts with 140. Cell Phone Number Service integrates the communications services provided by Alibaba Cloud. This allows you to initiate a call by using a virtual number that starts with 140.
+   * Encrypts an original phone number into a virtual phone number that starts with 140. By integrating with Alibaba Cloud communication services, you can use the encrypted 140 phone number to initiate voice calls, achieving the effect of a virtual phone number call.
    * 
    * @remarks
-   * Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 1,000 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * Before you use this API, log on to the Cell Phone Number Service console, go to the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, and fill in the application materials. You can use this API after the application is approved.
+   * ### QPS limit
+   * The per-user QPS limit of this API is 1,000 calls per second. If the number of API calls exceeds the limit, the calls will be throttled, which may affect your business. Call the API properly.
    * 
    * @param request - PhoneNumberEncryptRequest
    * @returns PhoneNumberEncryptResponse
@@ -1833,14 +2118,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Retrieves the real-time network status of a mobile phone number, such as active, shutdown, or non-existent. You can query numbers that are in plaintext or hashed using MD5 or SHA256.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you use this operation, make sure that you fully understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Intelligence.**
+   * - By default, only an Alibaba Cloud account can call this operation. A RAM user can call this operation only after receiving the required permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you use this operation, log on to the Phone Number Intelligence console. On the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Apply**, and then submit the required information. You can use this operation once your application is approved.
+   * - The phone number status query feature supports numbers from China Telecom, China Unicom, and China Mobile. This feature does not support numbers from China Broadnet. If you call this operation to query a China Broadnet number, the API returns the error code `OperatorLimit`, which indicates that the query is prohibited by the carrier.
+   * ### QPS limit
+   * This operation has a queries per second (QPS) limit of 300 per user. If you exceed this limit, your API calls are throttled, which may affect your services. We recommend that you call this operation at a reasonable frequency.
    * 
    * @param request - PhoneNumberStatusForAccountRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1891,14 +2177,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Retrieves the real-time network status of a mobile phone number, such as active, shutdown, or non-existent. You can query numbers that are in plaintext or hashed using MD5 or SHA256.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you use this operation, make sure that you fully understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Intelligence.**
+   * - By default, only an Alibaba Cloud account can call this operation. A RAM user can call this operation only after receiving the required permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you use this operation, log on to the Phone Number Intelligence console. On the [Tag Plaza](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Apply**, and then submit the required information. You can use this operation once your application is approved.
+   * - The phone number status query feature supports numbers from China Telecom, China Unicom, and China Mobile. This feature does not support numbers from China Broadnet. If you call this operation to query a China Broadnet number, the API returns the error code `OperatorLimit`, which indicates that the query is prohibited by the carrier.
+   * ### QPS limit
+   * This operation has a queries per second (QPS) limit of 300 per user. If you exceed this limit, your API calls are throttled, which may affect your services. We recommend that you call this operation at a reasonable frequency.
    * 
    * @param request - PhoneNumberStatusForAccountRequest
    * @returns PhoneNumberStatusForAccountResponse
@@ -1909,14 +2196,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Queries the real-time status of a mobile phone number to determine whether it is in service, suspended, or non-existent. This operation supports queries for plaintext numbers or numbers encrypted with MD5 or SHA256.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you call this operation, make sure that you fully understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Intelligence.**
+   * - By default, only an Alibaba Cloud account can call this operation. A RAM user must be granted the required permissions before calling this operation. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before calling this operation, log on to the Phone Number Intelligence console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Apply**, and submit your application. You can use the operation after your application is approved.
+   * - The number status query feature supports numbers from China Telecom, China Unicom, and China Mobile, but does not support numbers from China Broadnet. If you call this operation to query the status of a China Broadnet number, the `OperatorLimit` error code is returned, which indicates that the query is prohibited by the carrier.
+   * ### QPS limit
+   * The queries per second (QPS) limit for each user is 300. API calls that exceed this limit are throttled. To avoid business disruptions, plan your calls accordingly.
    * 
    * @param request - PhoneNumberStatusForPublicRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1967,14 +2255,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Queries the real-time status of a mobile phone number to determine whether it is in service, suspended, or non-existent. This operation supports queries for plaintext numbers or numbers encrypted with MD5 or SHA256.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you call this operation, make sure that you fully understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Intelligence.**
+   * - By default, only an Alibaba Cloud account can call this operation. A RAM user must be granted the required permissions before calling this operation. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before calling this operation, log on to the Phone Number Intelligence console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Apply**, and submit your application. You can use the operation after your application is approved.
+   * - The number status query feature supports numbers from China Telecom, China Unicom, and China Mobile, but does not support numbers from China Broadnet. If you call this operation to query the status of a China Broadnet number, the `OperatorLimit` error code is returned, which indicates that the query is prohibited by the carrier.
+   * ### QPS limit
+   * The queries per second (QPS) limit for each user is 300. API calls that exceed this limit are throttled. To avoid business disruptions, plan your calls accordingly.
    * 
    * @param request - PhoneNumberStatusForPublicRequest
    * @returns PhoneNumberStatusForPublicResponse
@@ -1985,14 +2274,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Queries the real-time status of a mobile phone number, such as normal, suspended, or not in service. This operation supports queries for phone numbers that are in plaintext or encrypted by using MD5, SHA256, or SM3.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before calling this operation, ensure you fully understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Intelligence.**
+   * - By default, only an Alibaba Cloud account can call this operation. To allow a RAM user to call this operation, you must first grant the required permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you call this operation, log on to the Phone Number Intelligence console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Request Activation**, and then submit your application. You can call this operation only after your application is approved.
+   * - This operation supports phone numbers from China Telecom, China Unicom, and China Mobile. Numbers from China Broadnet are not supported. If you call this operation to query a China Broadnet number, the API returns the error code `OperatorLimit` and an error message indicating that the query is restricted by the carrier.
+   * ### QPS limit
+   * The QPS limit for this operation is 300 queries per second (QPS) per user. The system throttles calls that exceed this limit, which may affect your business. Plan your calls accordingly.
    * 
    * @param request - PhoneNumberStatusForRealRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2043,14 +2333,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Queries the real-time status of a mobile phone number, such as normal, suspended, or not in service. This operation supports queries for phone numbers that are in plaintext or encrypted by using MD5, SHA256, or SM3.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before calling this operation, ensure you fully understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Intelligence.**
+   * - By default, only an Alibaba Cloud account can call this operation. To allow a RAM user to call this operation, you must first grant the required permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you call this operation, log on to the Phone Number Intelligence console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Request Activation**, and then submit your application. You can call this operation only after your application is approved.
+   * - This operation supports phone numbers from China Telecom, China Unicom, and China Mobile. Numbers from China Broadnet are not supported. If you call this operation to query a China Broadnet number, the API returns the error code `OperatorLimit` and an error message indicating that the query is restricted by the carrier.
+   * ### QPS limit
+   * The QPS limit for this operation is 300 queries per second (QPS) per user. The system throttles calls that exceed this limit, which may affect your business. Plan your calls accordingly.
    * 
    * @param request - PhoneNumberStatusForRealRequest
    * @returns PhoneNumberStatusForRealResponse
@@ -2061,14 +2352,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Retrieves the real-time network status of a phone number, such as active, shutdown, or non-existent. This operation supports queries for numbers in plaintext or numbers encrypted by using MD5, SHA256, or SM3.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you call this operation, make sure you understand the [Product Pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Pedia**.
+   * - By default, only an Alibaba Cloud account can call this operation. A RAM user can call this operation only after being granted the required permissions. For more information, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/154006.html).
+   * - Before calling this operation, log on to the Phone Number Pedia console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Request Activation**, and then complete the application form. You can use this operation only after your application is approved.
+   * - This feature supports phone numbers from China Telecom, China Unicom, and China Mobile, but does not support phone numbers from China Broadnet. If you call this operation to query the status of a China Broadnet number, the `OperatorLimit` error code and the "The number is limited by the operator." message are returned.
+   * ### QPS limit
+   * This operation is limited to 300 queries per second (QPS) for each user. Calls that exceed this limit are throttled, which may affect your business. Plan your calls accordingly.
    * 
    * @param request - PhoneNumberStatusForSmsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2119,14 +2411,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Retrieves the real-time network status of a phone number, such as active, shutdown, or non-existent. This operation supports queries for numbers in plaintext or numbers encrypted by using MD5, SHA256, or SM3.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you call this operation, make sure you understand the [Product Pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Pedia**.
+   * - By default, only an Alibaba Cloud account can call this operation. A RAM user can call this operation only after being granted the required permissions. For more information, see [Grant permissions to a RAM user](https://help.aliyun.com/document_detail/154006.html).
+   * - Before calling this operation, log on to the Phone Number Pedia console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Request Activation**, and then complete the application form. You can use this operation only after your application is approved.
+   * - This feature supports phone numbers from China Telecom, China Unicom, and China Mobile, but does not support phone numbers from China Broadnet. If you call this operation to query the status of a China Broadnet number, the `OperatorLimit` error code and the "The number is limited by the operator." message are returned.
+   * ### QPS limit
+   * This operation is limited to 300 queries per second (QPS) for each user. Calls that exceed this limit are throttled, which may affect your business. Plan your calls accordingly.
    * 
    * @param request - PhoneNumberStatusForSmsRequest
    * @returns PhoneNumberStatusForSmsResponse
@@ -2137,14 +2430,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Queries the real-time network status of a mobile phone number, such as normal, shutdown, or non-existent. This operation supports queries for numbers in plaintext and numbers encrypted by using MD5, SHA256, or SM3.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you use this API, make sure that you understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Encyclopedia**.
+   * - By default, only Alibaba Cloud accounts can call this API. To allow a RAM user to do so, you must grant them the required permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you use this API, log in to the Phone Number Encyclopedia console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Apply for Access**, and then complete the application form. You can call this API after your application is approved.
+   * - This feature supports phone numbers from China Telecom, China Unicom, and China Mobile, but not from China Broadnet. If you query a China Broadnet number, the `OperatorLimit` error code and an error message are returned: The number is limited by the operator.
+   * ### QPS limit
+   * The QPS limit for a single user is 300 queries per second. If you exceed this limit, the system throttles your API calls, which may impact your business. To avoid interruptions, call this API at a reasonable rate.
    * 
    * @param request - PhoneNumberStatusForVoiceRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2195,14 +2489,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the real-time service state of a phone number. The state includes NORMAL, SHUTDOWN, and NOT_EXIST. You can choose an encryption method for your phone number query, including plaintext, MD5, and SHA256.
+   * Queries the real-time network status of a mobile phone number, such as normal, shutdown, or non-existent. This operation supports queries for numbers in plaintext and numbers encrypted by using MD5, SHA256, or SM3.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   By default, only Alibaba Cloud accounts can call this operation. RAM users can call this operation only after the RAM users are granted the related permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 300 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - **Before you use this API, make sure that you understand the [pricing](https://help.aliyun.com/document_detail/154751.html) of Phone Number Encyclopedia**.
+   * - By default, only Alibaba Cloud accounts can call this API. To allow a RAM user to do so, you must grant them the required permissions. For more information, see [Grant permissions to RAM users](https://help.aliyun.com/document_detail/154006.html).
+   * - Before you use this API, log in to the Phone Number Encyclopedia console. On the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the required tag, click **Apply for Access**, and then complete the application form. You can call this API after your application is approved.
+   * - This feature supports phone numbers from China Telecom, China Unicom, and China Mobile, but not from China Broadnet. If you query a China Broadnet number, the `OperatorLimit` error code and an error message are returned: The number is limited by the operator.
+   * ### QPS limit
+   * The QPS limit for a single user is 300 queries per second. If you exceed this limit, the system throttles your API calls, which may impact your business. To avoid interruptions, call this API at a reasonable rate.
    * 
    * @param request - PhoneNumberStatusForVoiceRequest
    * @returns PhoneNumberStatusForVoiceResponse
@@ -2267,7 +2562,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 套餐包类型信息查询
+   * Queries package type information.
    * 
    * @param request - QueryPackageTypeInfoRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2310,7 +2605,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 套餐包类型信息查询
+   * Queries package type information.
    * 
    * @param request - QueryPackageTypeInfoRequest
    * @returns QueryPackageTypeInfoResponse
@@ -2503,7 +2798,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries information about tags.
+   * Queries tag information.
    * 
    * @param request - QueryTagInfoBySelectionRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2554,7 +2849,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries information about tags.
+   * Queries tag information.
    * 
    * @param request - QueryTagInfoBySelectionRequest
    * @returns QueryTagInfoBySelectionResponse
@@ -2565,7 +2860,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries a list of tags by page.
+   * Queries the tag list by page.
    * 
    * @param request - QueryTagListPageRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2612,7 +2907,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries a list of tags by page.
+   * Queries the tag list by page.
    * 
    * @param request - QueryTagListPageRequest
    * @returns QueryTagListPageResponse
@@ -2623,7 +2918,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询离线任务列表
+   * Queries a list of offline tasks.
    * 
    * @param tmpReq - QueryTaskListRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2700,7 +2995,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询离线任务列表
+   * Queries a list of offline tasks.
    * 
    * @param request - QueryTaskListRequest
    * @returns QueryTaskListResponse
@@ -2711,7 +3006,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the usage statistics based on tag IDs.
+   * Queries usage statistics by tag ID.
    * 
    * @param request - QueryUsageStatisticsByTagIdRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2770,7 +3065,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the usage statistics based on tag IDs.
+   * Queries usage statistics by tag ID.
    * 
    * @param request - QueryUsageStatisticsByTagIdRequest
    * @returns QueryUsageStatisticsByTagIdResponse
@@ -2781,7 +3076,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人保存
+   * Saves an alert contact.
+   * 
+   * @remarks
+   * - Before you call this operation, ensure you have activated Phone Number Intelligence.
    * 
    * @param request - SaveContactsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2852,7 +3150,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人保存
+   * Saves an alert contact.
+   * 
+   * @remarks
+   * - Before you call this operation, ensure you have activated Phone Number Intelligence.
    * 
    * @param request - SaveContactsRequest
    * @returns SaveContactsResponse
@@ -2863,14 +3164,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the name, phone number, and ID card number entered by a user belong to the same user.
+   * Verification of three elements (name, mobile phone number, and ID card number). Used to verify whether the name, mobile phone number, and ID card number entered by a user belong to the same user.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * *   You are charged only if the value of Code is OK and the value of IsConsistent is not 2.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 200 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - Before you call this API, make sure that you have fully understood the [pricing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
+   * - Before you call this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, fill in the application materials, and call the API after the application is approved.
+   * - Billing applies when the API returns Code=\\"OK\\" and IsConsistent != 2. Other return results are not billed.
+   * - The verification of virtual carrier numbers is not supported. Virtual carrier numbers refer to numbers that start with 170, 171, 162, or 165.
+   * ### QPS limit
+   * The QPS limit per user for this API is 200 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call the API in a reasonable manner.
    * 
    * @param request - ThreeElementsVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2929,14 +3231,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the name, phone number, and ID card number entered by a user belong to the same user.
+   * Verification of three elements (name, mobile phone number, and ID card number). Used to verify whether the name, mobile phone number, and ID card number entered by a user belong to the same user.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * *   You are charged only if the value of Code is OK and the value of IsConsistent is not 2.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 200 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - Before you call this API, make sure that you have fully understood the [pricing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
+   * - Before you call this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply for Activation**, fill in the application materials, and call the API after the application is approved.
+   * - Billing applies when the API returns Code=\\"OK\\" and IsConsistent != 2. Other return results are not billed.
+   * - The verification of virtual carrier numbers is not supported. Virtual carrier numbers refer to numbers that start with 170, 171, 162, or 165.
+   * ### QPS limit
+   * The QPS limit per user for this API is 200 calls per second. If the limit is exceeded, API calls are throttled, which may affect your business. Call the API in a reasonable manner.
    * 
    * @param request - ThreeElementsVerificationRequest
    * @returns ThreeElementsVerificationResponse
@@ -2947,14 +3250,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the name and phone number entered by a user belong to the same user.
+   * Two-element (name and phone number) verification. Used to compare whether the name and phone number entered by the user belong to the same user.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * *   You are charged only if the value of Code is OK and the value of IsConsistent is not 2.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 200 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - Before using this API, ensure that you fully understand the [product pricing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
+   * - Before using this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply to Enable**, fill in the application materials, and use it after the approval.
+   * - Billing is applied when the API returns Code="OK" and IsConsistent != 2. Other return results are not billed.
+   * - MVNO number verification is not supported. MVNO numbers refer to numbers starting with 170, 171, 162, and 165.
+   * ### QPS limit
+   * The per-user QPS limit of this API is 200 times/second. If the limit is exceeded, API calls will be throttled, which may affect your business. Please call the API reasonably.
    * 
    * @param request - TwoElementsVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -3009,14 +3313,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Verifies whether the name and phone number entered by a user belong to the same user.
+   * Two-element (name and phone number) verification. Used to compare whether the name and phone number entered by the user belong to the same user.
    * 
    * @remarks
-   *   Before you call this operation, make sure that you are familiar with the [billing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
-   * *   Before you call this operation, perform the following operations: Log on to the Cell Phone Number Service console. On the [Labels](https://dytns.console.aliyun.com/analysis/square) page, find the label that you want to use, click **Activate Now**, enter the required information, and then submit your application. After your application is approved, you can use the label.
-   * *   You are charged only if the value of Code is OK and the value of IsConsistent is not 2.
-   * ### [](#qps)QPS limits
-   * You can call this operation up to 200 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.
+   * - Before using this API, ensure that you fully understand the [product pricing](https://help.aliyun.com/document_detail/154751.html) of Cell Phone Number Service.
+   * - Before using this API, log on to the Cell Phone Number Service console, go to the [Tag Square](https://dytns.console.aliyun.com/analysis/square) page, find the corresponding tag, click **Apply to Enable**, fill in the application materials, and use it after the approval.
+   * - Billing is applied when the API returns Code="OK" and IsConsistent != 2. Other return results are not billed.
+   * - MVNO number verification is not supported. MVNO numbers refer to numbers starting with 170, 171, 162, and 165.
+   * ### QPS limit
+   * The per-user QPS limit of this API is 200 times/second. If the limit is exceeded, API calls will be throttled, which may affect your business. Please call the API reasonably.
    * 
    * @param request - TwoElementsVerificationRequest
    * @returns TwoElementsVerificationResponse
@@ -3171,7 +3476,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains a Uniform Anonymous Identifier (UAID) based on the authorization token of a carrier. For more information about how to obtain the authorization token and its signature value, see the GetUAIDApplyTokenSign documentation.
+   * Obtains a UAID based on the carrier authorization token.
+   * For information about how to obtain the authorization token and its signature, see the GetUAIDApplyTokenSign API documentation.
+   * A UAID is 64 characters in length. The first 32 characters describe the device information, and the last 32 characters describe the phone number information.
+   * 
+   * @remarks
+   * Before you call this API, make sure that you have fully understood the billing method and [pricing](https://www.aliyun.com/price/product#/dytns/detail/dytns_penqbag_public_cn) of Cell Phone Number Service.  
+   * Obtains a UAID based on the carrier authorization token.  
+   * For information about how to obtain the authorization token and its signature, see the GetUAIDApplyTokenSign API documentation.
    * 
    * @param request - UAIDVerificationRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -3238,7 +3550,14 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Obtains a Uniform Anonymous Identifier (UAID) based on the authorization token of a carrier. For more information about how to obtain the authorization token and its signature value, see the GetUAIDApplyTokenSign documentation.
+   * Obtains a UAID based on the carrier authorization token.
+   * For information about how to obtain the authorization token and its signature, see the GetUAIDApplyTokenSign API documentation.
+   * A UAID is 64 characters in length. The first 32 characters describe the device information, and the last 32 characters describe the phone number information.
+   * 
+   * @remarks
+   * Before you call this API, make sure that you have fully understood the billing method and [pricing](https://www.aliyun.com/price/product#/dytns/detail/dytns_penqbag_public_cn) of Cell Phone Number Service.  
+   * Obtains a UAID based on the carrier authorization token.  
+   * For information about how to obtain the authorization token and its signature, see the GetUAIDApplyTokenSign API documentation.
    * 
    * @param request - UAIDVerificationRequest
    * @returns UAIDVerificationResponse
@@ -3249,7 +3568,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人更新
+   * Updates an alert contact.
+   * 
+   * @remarks
+   * - Ensure that you have activated the Phone Number Information Service before calling this operation.
    * 
    * @param request - UpdateContactsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -3320,7 +3642,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 预警联系人更新
+   * Updates an alert contact.
+   * 
+   * @remarks
+   * - Ensure that you have activated the Phone Number Information Service before calling this operation.
    * 
    * @param request - UpdateContactsRequest
    * @returns UpdateContactsResponse
@@ -3330,4 +3655,62 @@ export default class Client extends OpenApi {
     return await this.updateContactsWithOptions(request, runtime);
   }
 
+  /**
+   * 虚商三要素
+   * 
+   * @param request - VirtualThreeElementsVerificationRequest
+   * @param runtime - runtime options for this request RuntimeOptions
+   * @returns VirtualThreeElementsVerificationResponse
+   */
+  async virtualThreeElementsVerificationWithOptions(request: $_model.VirtualThreeElementsVerificationRequest, runtime: $dara.RuntimeOptions): Promise<$_model.VirtualThreeElementsVerificationResponse> {
+    request.validate();
+    let query = { };
+    if (!$dara.isNull(request.authCode)) {
+      query["AuthCode"] = request.authCode;
+    }
+
+    if (!$dara.isNull(request.certCode)) {
+      query["CertCode"] = request.certCode;
+    }
+
+    if (!$dara.isNull(request.certName)) {
+      query["CertName"] = request.certName;
+    }
+
+    if (!$dara.isNull(request.inputNumber)) {
+      query["InputNumber"] = request.inputNumber;
+    }
+
+    if (!$dara.isNull(request.mask)) {
+      query["Mask"] = request.mask;
+    }
+
+    let req = new $OpenApiUtil.OpenApiRequest({
+      query: OpenApiUtil.query(query),
+    });
+    let params = new $OpenApiUtil.Params({
+      action: "VirtualThreeElementsVerification",
+      version: "2020-02-17",
+      protocol: "HTTPS",
+      pathname: "/",
+      method: "POST",
+      authType: "AK",
+      style: "RPC",
+      reqBodyType: "formData",
+      bodyType: "json",
+    });
+    return $dara.cast<$_model.VirtualThreeElementsVerificationResponse>(await this.callApi(params, req, runtime), new $_model.VirtualThreeElementsVerificationResponse({}));
+  }
+
+  /**
+   * 虚商三要素
+   * 
+   * @param request - VirtualThreeElementsVerificationRequest
+   * @returns VirtualThreeElementsVerificationResponse
+   */
+  async virtualThreeElementsVerification(request: $_model.VirtualThreeElementsVerificationRequest): Promise<$_model.VirtualThreeElementsVerificationResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    return await this.virtualThreeElementsVerificationWithOptions(request, runtime);
+  }
+
 }