网页接入指南
NOTE: 该方案适用于平台跳转到游戏页面并携带登录参数的接入方式。另一种 JS-SDK 接入请查看JS-SDK 接入指南。
游戏登入
说明
- 玩家登录成功后，会跳转到研发提供的登录url并带上以下参数
- 游戏研发方可根据以下参数回调验证用户真实性
请求URL
请求格式
| 参数 | 类型 | 必选 | 描述 |
|---|
| userId | long | 是 | 用户ID |
| token | String | 是 | Token |
| channelId | int | 是 | 渠道ID |
| aid | String | 否 | 广告标识 |
| device | String | 否 | 设备唯一标识 |
数据上报
说明
请求URL
- https://gw.begindcc.com/ufo/api/h5/stat
请求格式
- 请求方式: HTTP GET/POST
- Content-Type: application/x-www-form-urlencoded
| 参数 | 类型 | 必选 | 描述 |
|---|
| appId | int | 是 | 游戏ID由平台分配 |
| ts | long | 是 | 时间戳秒 |
| sign | String | 是 | 签名值参考签名算法，密钥使用APP_KEY |
| type | int | 是 | 统计类型，1创建角色，2进入游戏，3等级提升，4登出游戏, 6充值到账 |
| channelId | int | 是 | 渠道ID |
| userId | long | 是 | 用户ID |
| serverId | String | 是 | 服务器ID |
| serverName | String | 是 | 服务器名称 |
| roleId | String | 是 | 角色ID |
| roleName | String | 是 | 角色名称 |
| roleLevel | int | 是 | 角色等级 |
| money | int | 是 | 角色人民币对应货币余额 |
| vip | String | 是 | VIP等级 |
| roleCreateTime | long | 是 | 角色创建时间，Unix时间戳秒 |
| version | String | 是 | 游戏版本号: 1.3.1 |
| deviceId | String | 否 | 设备ID,游戏登入接口参数原值传入即可 |
| os | String | 否 | 系统类型：android/iOS |
| model | String | 否 | 机型：iPhone X |
| resolution | String | 否 | 分辨率：1024*768 |
| net | String | 否 | 设备网络类型：WIFI/2G/3G/4G |
| mac | String | 否 | mac地址 |
| osv | String | 否 | 设备操作系统版本: 6.0.1 |
| area | String | 否 | 地区：CHN/CN/中国 |
| extension | String | 否 | 扩展字段 |
响应格式
- Content-Type: application/json:charset=utf-8
| 参数 | 类型 | 描述 |
|---|
| code | int | 状态码 |
| msg | String | 提示信息 |
下单支付
建议采用iframe弹窗方式解决用户体验问题，具体实现由CP决定，例如：
请求URL
- https://gw.begindcc.com/ufo/api/h5/order
请求格式
- 请求方式: HTTP GET/POST
- Content-Type: application/x-www-form-urlencoded
| 参数 | 类型 | 必选 | 描述 |
|---|
| appId | int | 是 | 游戏ID由平台分配 |
| ts | long | 是 | 时间戳秒 |
| sign | String | 是 | 签名值参考签名算法，密钥使用APP_KEY |
| channelId | int | 是 | 渠道ID由平台分配 |
| userId | long | 是 | 用户ID |
| cpOrderId | String | 是 | 游戏订单号要求唯一 |
| productId | String | 是 | 商品ID |
| productName | String | 是 | 商品名称 |
| productDesc | String | 是 | 商品描述 |
| currency | String | 是 | 货币类型，比如CNY，ISO4217 |
| price | int | 是 | 单位分 |
| serverId | String | 是 | 服务器ID |
| serverName | String | 是 | 服务器名称 |
| roleId | String | 是 | 角色ID |
| roleName | String | 是 | 角色名称 |
| roleLevel | int | 是 | 角色等级 |
| extension | String | 否 | 透传字段，游戏自定义参数，原样返回 |
| notifyUrl | String | 否 | 回调地址 |