Skip to content

Z
zw_game_sdk
提交 fb7b0bc0 作者: 赵倩倩
操作

feat: 种花道具 H5 领取链接接口

上级 1943f4f1
正在显示 包含 95 行增加 和 32 行删除
SDK对接说明.md
# 游戏 SDK 对接文档-v1.3.0
# 游戏 SDK 对接文档-v1.3.0
......@@ -851,30 +851,30 @@ zwsdk.createOrder(config:Object)
##### 请求参数
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
> | :------------------------------------------------------------ | :---- | :------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
> | order | true | Object | - | 订单相关 |
> |         cp_order_id | true | String | - | 游戏传入的外部订单号，服务器会根据这个订单号生成对应的平台订单号，请保证每笔订单传入的订单号的唯一性 |
> |         product_price | true | String | - | 商品价格（单价，单位：分） |
> |         product_id | true | String | - | 商品 ID |
> |         amount | true | String | - | 商品总价（单位：分） |
> |         product_cnt | true | String | - | 商品数量 |
> |         product_name | true | String | - | 商品名称 |
> |         product_desc | true | String | - | 商品描述 |
> |         ext | true | String | "" | CP 自定义扩展字段，透传信息 |
> | role | true | Object | - | 角色相关 |
> |         event | true | String | - | 角色事件 固定 recharge |
> |         server_id | true | String | "" | 游戏服务器 ID |
> |         server_name | true | String | "" | 游戏服务器名称 |
> |         cp_role_id | true | String | "" | 玩家角色 ID |
> |         role_name | true | String | "" | 玩家角色名称 |
> |         role_level | true | String | "0" | 玩家角色等级 |
> |         role_vip | true | String | "0" | 玩家 VIP 等级 |
> | showLoading | false | Boolean | false | 异步请求中，是否显示微信小程序 loading 提示框 |
> | loadingParams | false | Object | - | showLoading 为 true 时生效。与[微信小程序 showLoading](https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.showLoading.html) 参数一致 |
> | showToast | false | Boolean | false | 异步请求失败，是否显示微信小程序消息提示框 <br>异步请求成功，若要显示消息提示，需主动调用微信小程序消息提示框框 |
> | toastParams | false | Object | - | showLoading 为 true 时生效。与[微信小程序 showToast](https://developers.weixin.qq.com/minigame/dev/api/ui/interaction/wx.showToast.html) 参数一致 |
> | payReponse | false | Function | - | 支付结果回调函数，若拉起支付成功返回{ msg: 'success' }，若拉起支付失败返回{ msg: 'error' } |
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
> | :------------------------------------------------------------ | :---- | :------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
> | order | true | Object | - | 订单相关 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cp_order_id | true | String | - | 游戏传入的外部订单号，服务器会根据这个订单号生成对应的平台订单号，请保证每笔订单传入的订单号的唯一性 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;product_price | true | String | - | 商品价格（单价，单位：分） |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;product_id | true | String | - | 商品 ID |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;amount | true | String | - | 商品总价（单位：分） |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;product_cnt | true | String | - | 商品数量 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;product_name | true | String | - | 商品名称 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;product_desc | true | String | - | 商品描述 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ext | true | String | "" | CP 自定义扩展字段，透传信息 |
> | role | true | Object | - | 角色相关 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;event | true | String | - | 角色事件 固定 recharge |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;server_id | true | String | "" | 游戏服务器 ID |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;server_name | true | String | "" | 游戏服务器名称 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cp_role_id | true | String | "" | 玩家角色 ID |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;role_name | true | String | "" | 玩家角色名称 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;role_level | true | String | "0" | 玩家角色等级 |
> | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;role_vip | true | String | "0" | 玩家 VIP 等级 |
> | showLoading | false | Boolean | false | 异步请求中，是否显示微信小程序 loading 提示框 |
> | loadingParams | false | Object | - | showLoading 为 true 时生效。与[微信小程序 showLoading](https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.showLoading.html) 参数一致 |
> | showToast | false | Boolean | false | 异步请求失败，是否显示微信小程序消息提示框 <br>异步请求成功，若要显示消息提示，需主动调用微信小程序消息提示框框 |
> | toastParams | false | Object | - | showLoading 为 true 时生效。与[微信小程序 showToast](https://developers.weixin.qq.com/minigame/dev/api/ui/interaction/wx.showToast.html) 参数一致 |
> | payReponse | false | Function | - | 支付结果回调函数，若拉起支付成功返回{ msg: 'success' }，若拉起支付失败返回{ msg: 'error' } |
##### 返回参数
......@@ -1632,12 +1632,12 @@ zwsdk.reportFlower(config:Object)
##### 请求参数
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
> | :------- | :---- | :----- | :----- | :---------------- |
> | role_name | true | String | '' | 角色名称 |
> | cp_role_id | true | String | '' | 角色名称 |
> | expire_time | true | String | '' | 道具过期时间（秒级时间戳） |
> | prop_id | true | String | '' | 道具 id |
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
> | :---------- | :--- | :----- | :----- | :------------------------- |
> | role_name | true | String | '' | 角色名称 |
> | cp_role_id | true | String | '' | 角色名称 |
> | expire_time | true | String | '' | 道具过期时间（秒级时间戳） |
> | prop_id | true | String | '' | 道具 id |
##### 返回参数
......@@ -1663,7 +1663,7 @@ zwsdk
role_name: '微信小游戏种花道具上报',
cp_role_id: '1001_168128004_122',
expire_time: '1766039631',
prop_id: '123',
prop_id: '123'
})
.then((res) => {
// .......
......@@ -1672,3 +1672,66 @@ zwsdk
})
.catch((err) => {})
```
### 3.19 种花道具 H5 领取链接接口（种花游戏专用）<a name="sec3.18"></a>
---
##### 接口说明
> **\***种花游戏使用鲜花道具时使用（注：只有种花游戏接入），返回 Promise 对象
##### 调用方式
```javascript
zwsdk.getFlowerUrl(config:Object)
```
##### 请求参数
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
> | :------ | :--- | :----- | :----- | :------ |
> | prop_id | true | String | '' | 道具 id |
##### 返回参数
> | 参数 | 类型 | 说明 |
> | :---------- | :----- | :----- | ------ | -------- |
> | status_code | String | | | 返回状态 |
> | msg | String | | | 返回信息 |
> | data | Object | | | 用户数据 |
> | | data | Object | | 用户数据 |
> | | | url | String | 游戏链接 |
##### 返回数据样例
```javascript
{
"status_code": 1,
"msg": "获取成功",
"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"
}
},
"extra": {}
}
```
##### sdk 调用示例
```javascript
zwsdk
.getFlowerUrl({
prop_id: '123'
})
.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"
// }
})
.catch((err) => {})
```
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑！
请 注册 或者 后发表评论