@yunzhanghu/sdk-nodejs 1.0.3 → 1.0.5

package/.eslintignore

@@ -1,4 +1,5 @@
 node_modules
 package.json
 .eslintrc.json
-yzh
+yzh
+example

package/README.md

@@ -108,9 +108,12 @@ const client = new yunzhanghu.InvoiceClient({
 // 如：GetInvoiceAmount 查询可开具发票额度和发票开具信息
 client
   .GetInvoiceAmount({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: process.env.DEALER_ID,
     broker_id: process.env.BROKER_ID,

package/example/apiUserSign.js

@@ -7,9 +7,12 @@ const apiusersign = new yzhAPI.ApiUserSignServiceClient(config)
 // 获取协议预览 URL
 apiusersign
   .ApiUserSignContract({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -31,9 +34,12 @@ apiusersign
 // 用户签约
 apiusersign
   .ApiUserSign({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -59,9 +65,12 @@ apiusersign
 // 获取用户签约状态
 apiusersign
   .GetApiUserSignStatus({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -86,9 +95,12 @@ apiusersign
 // 用户解约（测试账号专用接口）
 apiusersign
   .ApiUserSignRelease({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: this.dealer_id,
     broker_id: this.broker_id,

package/example/authentication.js

@@ -9,9 +9,12 @@ const authentication = new yzhAPI.AuthenticationClient(config)
 // 银行卡四要素鉴权请求（下发短信验证码）
 authentication
   .BankCardFourAuthVerify({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     real_name: "张三",
     card_no: "8888888888888888888",
@@ -35,9 +38,12 @@ authentication
 // 银行卡四要素确认请求（上传短信验证码）
 authentication
   .BankCardFourAuthConfirm({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     real_name: "张三",
     card_no: "8888888888888888888",
@@ -63,9 +69,12 @@ authentication
 // 银行卡四要素验证
 authentication
   .BankCardFourVerify({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     real_name: "张三",
     card_no: "8888888888888888888",
@@ -89,9 +98,12 @@ authentication
 // 银行卡三要素验证
 authentication
   .BankCardThreeVerify({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     real_name: "张三",
     card_no: "8888888888888888888",
@@ -114,9 +126,12 @@ authentication
 // 身份证实名验证
 authentication
   .IDCardVerify({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     real_name: "张三",
     id_card: "110121202202222222",
@@ -138,9 +153,12 @@ authentication
 // 银行卡信息查询
 authentication
   .GetBankCardInfo({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     card_no: "8888888888888888888",
     bank_name: "招商银行",
@@ -173,9 +191,12 @@ function parse(file) {
 // 上传免验证用户名单信息
 authentication
   .UserExemptedInfo({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     id_card: "parssport0001",
     card_type: "passport",
@@ -207,9 +228,12 @@ authentication
 // 查看免验证用户名单是否存在
 authentication
   .UserWhiteCheck({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     id_card: "110121202202222222",
     real_name: "测试",

package/example/bizlicXjjH5.js

@@ -10,9 +10,12 @@ const bizlicxjjh5 = new yzhAPI.BizlicXjjH5ServiceClient({
 // 预启动
 bizlicxjjh5
   .H5GetStartUrl({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -40,9 +43,12 @@ bizlicxjjh5
 // 查询个体工商户状态
 bizlicxjjh5
   .H5EcoCityAicStatus({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,

package/example/bizlicXjjH5Api.js

@@ -10,9 +10,12 @@ const bizlicxjjh5api = new yzhAPI.BizlicXjjH5APIServiceClient({
 // 工商实名信息录入
 bizlicxjjh5api
   .H5PreCollectBizlicMsg({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -43,9 +46,12 @@ bizlicxjjh5api
 // 预启动
 bizlicxjjh5api
   .H5APIGetStartUrl({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -73,9 +79,12 @@ bizlicxjjh5api
 // 查询个体工商户状态
 bizlicxjjh5api
   .H5APIEcoCityAicStatus({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,

package/example/custom.js

@@ -0,0 +1,53 @@
+const yzhAPI = require('../yzh/index.js');
+const config = require('./conf/config.js');
+
+// 通用请求函数
+const customClient = new yzhAPI.CustomClient(config);
+
+// 接口参数
+const req = {
+    /**
+     * @param {string} request-id：请求 ID，请求的唯一标识
+     * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+     * 如未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+     */
+    request_id: 'requestIdExample123456789',
+    order_id: '202009010016562012987',
+    dealer_id: config.dealer_id,
+    broker_id: config.broker_id,
+    real_name: '张三',
+    card_no: '6228888888888888888',
+    id_card: '11010519891231002X',
+    pay: '100.00',
+    pay_remark: '',
+    notify_url: 'https://www.example.com',
+};
+// 接口请求地址
+const url = '/api/payment/v1/order-bankpay';
+
+// 接口请求方式
+const method = 'post';
+
+/**
+ * 通用请求函数
+ * 适用于 SDK 暂未支持的接口
+ * 以“银行卡实时支付”接口为例
+ */
+customClient
+    .doRequest(req, url, method)
+    .then(data => {
+        if (data.code === '0000') {
+            // 操作成功
+            console.log('操作成功，', data.data);
+        } else {
+            // 失败返回
+            console.log(
+                '失败返回，',
+                'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id
+            );
+        }
+    })
+    .catch(err => {
+        // 发生异常
+        console.log(err.toString());
+    });

package/example/dataService.js

@@ -7,9 +7,12 @@ const dataService = new yzhAPI.DataServiceClient(config)
 // 查询日订单文件
 dataService
   .GetDailyOrderFile({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     order_date: "2023-01-13",
   })
@@ -30,9 +33,12 @@ dataService
 // 查询日流水文件
 dataService
   .GetDailyBillFileV2({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     bill_date: "2023-01-13",
   })
@@ -53,9 +59,12 @@ dataService
 // 查询平台企业预付业务服务费记录
 dataService
   .ListDealerRechargeRecordV2({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     begin_at: "2023-01-01",
     end_at: "2023-01-30",
@@ -77,9 +86,12 @@ dataService
 // 查询日订单数据
 dataService
   .ListDailyOrder({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     order_date: "2023-01-13",
     offset: 0,
@@ -104,9 +116,12 @@ dataService
 // 查询日订单文件（支付和退款订单）
 dataService
   .GetDailyOrderFileV2({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     order_date: "2023-01-13",
   })
@@ -127,9 +142,12 @@ dataService
 // 查询日流水数据
 dataService
   .ListDailyBill({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     bill_date: "2022-10-28",
     offset: 0,
@@ -153,9 +171,12 @@ dataService
 // 查询余额日账单数据
 dataService
   .ListBalanceDailyStatement({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     statement_date: "2022-10-28",
   })

package/example/h5UserSign.js

@@ -7,9 +7,12 @@ const h5usersign = new yzhAPI.H5UserSignServiceClient(config)
 // 预申请签约
 h5usersign
   .H5UserPresign({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -34,9 +37,12 @@ h5usersign
 // 申请签约
 h5usersign
   .H5UserSign({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     token: "55866120-532d-44dd-9251-cf453c7f4c63",
     color: "",
@@ -60,9 +66,12 @@ h5usersign
 // 获取用户签约状态
 h5usersign
   .GetH5UserSignStatus({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -86,9 +95,12 @@ h5usersign
 // 用户解约（测试账号专用接口）
 h5usersign
   .H5UserRelease({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,

package/example/invoice.js

@@ -7,9 +7,12 @@ const invoice = new yzhAPI.InvoiceClient(config)
 // 查询平台企业已开具和待开具发票金额
 invoice
   .GetInvoiceStat({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -32,9 +35,12 @@ invoice
 // 查询可开具发票额度和发票开具信息
 invoice
   .GetInvoiceAmount({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -56,9 +62,12 @@ invoice
 // 发票开具申请
 invoice
   .ApplyInvoice({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
@@ -86,9 +95,12 @@ invoice
 // 查询发票开具申请状态
 invoice
   .GetInvoiceStatus({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     invoice_apply_id: "test1234567890",
     application_id: "417481",
@@ -110,9 +122,12 @@ invoice
 // 下载 PDF 版发票
 invoice
   .GetInvoiceFile({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     invoice_apply_id: "test1234567890",
     application_id: "417481",
@@ -134,9 +149,12 @@ invoice
 // 发送发票扫描件压缩包下载链接邮件
 invoice
   .SendReminderEmail({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     invoice_apply_id: "test1234567890",
     application_id: "416286",
@@ -158,9 +176,12 @@ invoice
 // 查询发票信息
 invoice
   .GetInvoiceInformation({
-    // request-id：请求 ID，请求的唯一标识
-    // 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
-    // 如平台企业未自定义 request-id，将使用 SDK 中的 random 方法自动生成。注意：random 方法生成的 request-id 不能保证全局唯一，推荐自定义
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
     request_id: "requestIdExample123456789",
     invoice_apply_id: "test1234567890",
     application_id: "423721",