feat: 新增种花论坛跳转

SDK对接说明.md

-# 游戏 SDK 对接文档-v1.3.0
+# 游戏 SDK 对接文档-v1.3.0
@@ -254,6 +254,18 @@
 
         示例
 
+    3.19 [SDK 种花论坛小程序跳转（种花游戏专用）](#sec3.19)
+
+        接口说明
+
+        调用方式
+
+        请求参数
+
+        返回参数
+
+        示例
+
 ## 1. 接入说明<a name="sec1"></a>
 
 ### 1.1 术语表<a name="sec1.1"></a>
@@ -1540,7 +1552,7 @@ EVENT 属性对应关系
 熊猫大作战 EVENT 枚举
 
 > | EVENT                   | 说明           |
-> | ----------------------------- | ------------- |
+> | ----------------------- | -------------- |
 > | promotion_complete      | 晋升完成       |
 > | follower_start_up       | 随从星级升级   |
 > | bounty_accept_task_num  | 悬赏接取任务数 |
@@ -1553,24 +1565,24 @@ EVENT 属性对应关系
 熊猫大作战 EVENT 属性对应关系
 
 > | follower_start_up 属性名 |
-> | ------------ |
+> | ------------------------ |
 > | 随从等级                 |
 
 > | bounty_accept_task_num 属性名 |
-> | ------------ |
+> | ----------------------------- |
 > | 任务数量                      |
 
 > | bounty_refresh_task_num 属性名 |
-> | ------------ |
+> | ------------------------------ |
 > | 任务数量                       |
 
 > | arena_points_inc 属性名 |
-> | ------------ |
+> | ----------------------- |
 > | 竞技场提升积分          |
 > | 竞技场积分              |
 
 > | item_get 属性名 |
-> | ------------ |
+> | --------------- |
 > | 道具ID          |
 > | 道具产出途径    |
 > | 变动前数量      |
@@ -1578,7 +1590,7 @@ EVENT 属性对应关系
 > | 变动后数量      |
 
 > | item_cost 属性名 |
-> | ------------ |
+> | ---------------- |
 > | 道具ID           |
 > | 道具产出途径     |
 > | 变动前数量       |
@@ -1586,7 +1598,7 @@ EVENT 属性对应关系
 > | 变动后数量       |
 
 > | shop 属性名 |
-> | ------------ |
+> | ----------- |
 > | 礼包名称    |
 > | 礼包金额    |
 
@@ -1726,48 +1738,42 @@ zwsdk
   .catch((err) => {})
 ```
 
-### 3.19 种花道具 H5 领取链接接口（种花游戏专用）<a name="sec3.18"></a>
+### 3.19 种花论坛小程序跳转（种花游戏专用）<a name="sec3.19"></a>
 
 ---
 
 ##### 接口说明
 
-> **\***种花游戏使用鲜花道具时使用（注：只有种花游戏接入），返回 Promise 对象
+> **\***种花游戏跳转论坛/关联小程序时使用（注：只有种花游戏接入）。SDK 先请求服务端获取目标小程序 `appId` 与 `path`，再调用 [wx.navigateToMiniProgram](https://developers.weixin.qq.com/minigame/dev/api/navigate/wx.navigateToMiniProgram.html) 打开；返回 Promise 对象。
 
 ##### 调用方式
 
 ```javascript
-zwsdk.getFlowerUrl(config:Object)
+zwsdk.jumpFlowerForum(config:Object)
 ```
 
 ##### 请求参数
 
 > | 参数   | 必选  | 类型   | 默认值 | 说明                                                        |
-> | :------ | :--- | :----- | :----- | :------ |
-> | prop_id | true | String | ''     | 道具 id |
+> | :----- | :---- | :----- | :----- | :---------------------------------------------------------- |
+> | gameId | false | String | ''     | 游戏 id，对应接口 `/mini_sdk/game/getJumpData` 的 `game_id` |
 
 ##### 返回参数
 
-> | 参数        | 类型   | 说明   |
-> | :---------- | :----- | :----- | ------ | -------- |
-> | status_code | String |        |        | 返回状态 |
-> | msg         | String |        |        | 返回信息 |
-> | data        | Object |        |        | 用户数据 |
-> |             | data   | Object |        | 用户数据 |
-> |             |        | url    | String | 游戏链接 |
+> 与 SDK 内部请求 `/mini_sdk/game/getJumpData` 的响应一致；成功时 `resolve` 传入该响应对象。跳转失败或请求失败时 `reject`。
 
 ##### 返回数据样例
 
+> 以下为服务端接口常见数据结构示意（以实际联调为准）；`data.app_id`、`data.path` 会用于 `wx.navigateToMiniProgram`。
+
 ```javascript
 {
     "status_code": 1,
-    "msg": "获取成功",
-    "data": {
+    "msg": "操作成功",
     "data": {
-            "url": "http://landingdev.zwwlkj03.top/flowerOrder/index.html?dev=1&pd=LJvH8NHKFH7Jrn0MFKLFt5bHKgVo20Y7J7fHPMl-6Xg%3D&t=2&token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJ6c2FwaS56d3dsa2owMy50b3AiLCJhdWQiOiJ6c2FwaS56d3dsa2owMy50b3AiLCJpYXQiOjE3Njg0NzY4MjMsImRhdGEiOnsiaWQiOiIzNjI1OTg3MDUiLCJnYW1lX2lkIjoiNDYiLCJwbGF5ZXJfaWQiOiIzMjMzODIyODIifX0.ozbB8UHLtjwBsERIJDArS_zzj233QZNcwcqLplFG9-U#46"
+        "app_id": "目标小程序 appId",
+        "path": "pages/index/index"
     }
-    },
-    "extra": {}
 }
 ```
 
@@ -1775,16 +1781,13 @@ zwsdk.getFlowerUrl(config:Object)
 
 ```javascript
 zwsdk
-  .getFlowerUrl({
-    prop_id: '123'
+  .jumpFlowerForum({
+    gameId: 'your_game_id'
   })
   .then((res) => {
     // .......
-    // res.status  返回状态
-    // res.msg  返回信息
-    //     res.data.data: {
-    //         "url": "http://landingdev.zwwlkj03.top/flowerOrder/index.html?dev=1&pd=LJvH8NHKFH7Jrn0MFKLFt5bHKgVo20Y7J7fHPMl-6Xg%3D&t=2&token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJ6c2FwaS56d3dsa2owMy50b3AiLCJhdWQiOiJ6c2FwaS56d3dsa2owMy50b3AiLCJpYXQiOjE3Njg0NzY4MjMsImRhdGEiOnsiaWQiOiIzNjI1OTg3MDUiLCJnYW1lX2lkIjoiNDYiLCJwbGF5ZXJfaWQiOiIzMjMzODIyODIifX0.ozbB8UHLtjwBsERIJDArS_zzj233QZNcwcqLplFG9-U#46"
-    // }
+    // res.status_code、res.msg 等以接口实际为准
+    // 成功后已发起 wx.navigateToMiniProgram
   })
   .catch((err) => {})
 ```