合并分支 'release' 到 'master'

微信种花上报sdk

查看合并请求 zwwl/zw_game_sdk!251

SDK对接说明.md

-# 游戏 SDK 对接文档-v1.3.0
+# 游戏 SDK 对接文档-v1.3.0
@@ -242,6 +242,18 @@
 
         示例
 
+    3.18 [SDK 种花道具上报（种花游戏专用）](#sec3.18)
+
+        接口说明
+
+        调用方式
+
+        请求参数
+
+        返回参数
+
+        示例
+
 ## 1. 接入说明<a name="sec1"></a>
 
 ### 1.1 术语表<a name="sec1.1"></a>
@@ -1599,3 +1611,60 @@ zwsdk
     // res.msg  返回信息
   })
 ```
+
+### 3.18 种花道具上报（种花游戏专用）<a name="sec3.18"></a>
+
+---
+
+##### 接口说明
+
+> **\***种花游戏使用鲜花道具时上报使用（注：只有种花游戏接入），返回 Promise 对象
+
+##### 调用方式
+
+```javascript
+zwsdk.reportFlower(config:Object)
+```
+
+##### 请求参数
+
+> | 参数     | 必选  | 类型   | 默认值 | 说明                |
+> | :------- | :---- | :----- | :----- | :---------------- |
+> | role_name | true | String | ''      | 角色名称          |
+> | cp_role_id | true | String | ''      | 角色名称          |
+> | expire_time | true | String | ''      | 道具过期时间（秒级时间戳） |
+> | prop_id | true | String | ''      | 道具 id |
+
+##### 返回参数
+
+> | 参数        | 类型   | 说明     |
+> | :---------- | :----- | :------- |
+> | status_code | Int    | 返回状态 |
+> | msg         | String | 返回信息 |
+
+##### 返回数据样例
+
+```javascript
+{
+    "status_code": 1,
+    "msg": "上报成功",
+}
+```
+
+##### sdk 调用示例
+
+```javascript
+zwsdk
+  .reportFlower({
+    role_name: '微信小游戏种花道具上报',
+    cp_role_id: '1001_168128004_122',
+    expire_time: '1766039631',
+    prop_id: '123',
+  })
+  .then((res) => {
+    // .......
+    // res.status  返回状态
+    // res.msg  返回信息
+  })
+  .catch((err) => {})
+```