# IC1101 Cocos API #### 一、通用说明 通用前缀: http://192.168.7.231:7379/new_battle 万能验证码 : `0123456789` 请求方式: `Get` 测试客户端: 加密说明 测试秘钥（正式服记得替换）: `ad78144c4e331a3e6bb811286247c3ec` 将加密参数已字母顺序排列 ，通过 `|` 拼接 ，做MD5加密 原始串 ```http http://127.0.0.1:7379/new_battle/accountRegister?account=a1&pwd=12321323&email=guoliang@gliangliang.com&emailCode=0123456789&sign=0f6aa27a4e529987d808162e38e731ef×tamp=1676373020000&loginType=1 ``` ```java account=a1|email=guoliang@gliangliang.com|emailcode=null|logintype=null|pwd=12321323|timestamp=1676373020000| ``` ```java account=a1|email=guoliang@gliangliang.com|emailcode=null|logintype=null|pwd=12321323|timestamp=1676373020000|ad78144c4e331a3e6bb811286247c3ec ``` ```java 58002e207bd66b6390658574e8433fab ``` #### 二、枚举定义 ##### 1.登录类型枚举 `ChannelEnum` ```java public enum ChannelEnum { WD(1, "wallect connect QR code"), MetaMask(2, "Metamask网页登录"), GameAccounupt(3, "游戏账号登录"), Guest(4, "游客登录"), Zh(5, "国服登录"), UNKNOWN(1000, "未知"); } ``` ##### 2.钱包类型 `WalletEnum` ```java public enum WalletEnum { Game(1, "游戏小钱包"), Auth(2, "认证的WEB3钱包"), UNKNOWN(1000, "未知"); } ``` ##### 3.登录类型 `LoginEnum` ```java public enum LoginEnum { Cocos(1, "Cocos"), PcUe5(2, "PcUe5"), WebSite(3, "官网"); } ``` ##### 4.用户性别 `CocosUserGenderEnum` ```java public enum CocosUserGenderEnum { Male(1, "男"), Female(2, "女"), UNKNOWN(1000, "未知"); } ``` ##### 5.道具状态 `CocosItemStatusEnum` ```java public enum CocosItemStatusEnum { Idle(0, "空闲"), Equip(1, "装饰中"), UNKNOWN(1000, "未知"); } ``` ##### 5.slot type `CocosItemTypeEnum` ```java public enum CocosItemTypeEnum { Hair_M(100, "发型（男）"), Hair_F(101, "发型（女）"), Cloth_M(102, "上衣（男）"), Cloth_F(103, "上衣（女）"), Trousers_M(104,"裤子（男）"), Trousers_F(105,"裤子（女）"), Shoe_M(106,"鞋子（男）"), Shoe_F(107,"鞋子（女）"), Suit_M(108,"套装（男）"), Suit_F(109,"套装（女）"), Special_Avatar(110,"特殊形象"), Floor_Sprite(200,"地板贴图"), Wall_Sprite(201,"墙面贴图"), Furniture(202,"家具"), Wall_Widget(203,"墙面装饰"), Pendant_Widget(204,"吊灯装饰"), PicFrame(205,"画框"), Pic(206,"相册"), Space_s(300,"小空间"), Space_m(301,"中空间"), Space_l(302,"大空间"), Space_o(303,"特殊空间"), UNKNOWN(1000, "未知"); } ``` #### 三、API列表 ##### 1.多渠道登录接口 `/loginByChannel ` image-20230215193208858 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ------------------------------------------------------------ | | channelId | int | 否 | 是 | 1.二维码walletconnect扫码登录 2.钱包登录metamask 3.传统账密登录 ,具体见ChannelEnum结构 4.游客登录 | | account | string | 否 | 是 | 账号名 | | pwd | string | 是 | 否 | 密码 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 否 | 是 | 时间戳 毫秒 | | loginType | int | 否 | 是 | 登录类型，具体见LoginEnum结构 | ```http http://192.168.7.221:7379/new_battle/loginByChannel?channelId=1&account=0xeccbc87e4b5ce2fe28308fd9f2a7baf3&sign=0f6aa27a4e529987d808162e38e731ef×tamp=1676373020000&loginType=1 ``` 返回: ```json { "data": { "account": "", "authWallets": [ { "address": "0xeccbc87e4b5ce2fe28308fd9f2a7baf3", "createAt": 1677058652012, "createTime": "2023-02-22 17:37:32", "id": 12 } ], "bindAt": -1, "bindTime": "", "channelId": 1, "createAt": 1677058646727, "createTime": "2023-02-22 17:37:26", "edit": false, "email": "", "id": 13, "inviteCode": "6L79MG1TBP", "lastLoginAt": 1677058652048, "lastLoginIp": "192.168.7.231", "lastLoginTime": "2023-02-22 17:37:32", "loginType": 1, "nickName": "0xeccbc87e4b5ce2fe28308fd9f2a7baf3", "score": 100, "smallWallet": { "address": "0x00000000000000000000000000000000", "createAt": 1677058651989, "createTime": "2023-02-22 17:37:31", "hdIdx": 12, "id": 12 }, "status": 1, "token": "ZNVEtxogWA", "tokenExpireAt": 1677317852048, "tokenExpireTime": "2023-02-25 17:37:32", "user": { "accountId": 13, "createAt": 1677058651987, "createTime": "2023-02-22 17:37:31", "nickName": "0xeccbc87e4b5ce2fe28308fd9f2a7baf3" } }, "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 2 .web端账号绑定接口 `/bindAccountWithWallet` ![](https://mdres20230215.oss-cn-shanghai.aliyuncs.com/bindwallet.png) **牵涉到的功能** - 邮箱验证码认证 - 上级用户邀请码溯源后的积分增加 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | ------------- | ------ | -------- | ------------ | -------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | account | string | 否 | 是 | 账号名 | | pwd | string | 否 | 否 | 密码 | | email | string | 否 | 是 | 邮箱 | | emailCode | string | 否 | 否 | 邮箱验证码 | | srcInviteCode | string | 否 | 否 | 我上级的邀请码 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 否 | 是 | 时间戳 毫秒 | ```http http://127.0.0.1:7379/new_battle/bindAccountWithWallet?account=a1&pwd=123456&email=a1@qq.com&emailCode=xjhung&srcInviteCode=loqsx&sign=0f6aa27a4e529987d808162e38e731ef×tamp=1676373020000&token=kjumh ``` 返回: ```json { "data": { "account": "a1", "authWallets": [ { "address": "0xeccbc87e4b5ce2fe28308fd9f2a7baf3", "createAt": 1676459788011, "createTime": "2023-02-15 19:16:28", "id": 7 } ], "channelId": 1, "createAt": 1676459787846, "createTime": "2023-02-15 19:16:27", "edit": true, "email": "a1@qq.com", "id": 8, "inviteCode": "ADSFCSNPCU", "lastLoginIp": "", "nickName": "a1", "score": 0, "smallWallet": { "address": "0x00000000000000000000000000000000", "createAt": 1676459787993, "createTime": "2023-02-15 19:16:27", "hdIdx": 7, "id": 7 } }, "errCode": 0, "errMsg": "Success" } ``` ##### 3 .账号信息接口 `/accountInfo` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | loginType | int | 否 | 是 | 登录类型，具体见LoginEnum结构 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 否 | 是 | 时间戳 毫秒 | 请求 ```http http://127.0.0.1:7379/new_battle/accountInfo?token=oZtH7N6ovx&sign=0f6aa27a4e529987d808162e38e731ef×tamp=1676373020000 ``` 返回 ```json { "data": { "account": "test1111", "bindAt": -1, "bindTime": "", "channelId": 3, "createAt": 1677121736738, "createTime": "2023-02-23 11:08:56", "edit": true, "email": "guoliang@gliangliang.com", "id": 14, "inviteCode": "MHVXK00ZBK", "lastLoginAt": 0, "lastLoginIp": "127.0.0.1", "loginType": 0, "nickName": "test1111", "score": 100, "smallWallet": { "address": "0x00000000000000000000000000000000", "createAt": 1677121738056, "createTime": "2023-02-23 11:08:58", "hdIdx": 13, "id": 13 }, "status": 0, "token": "fFRHmZKSoh", "tokenExpireAt": 1677380938998, "tokenExpireTime": "2023-02-26 11:08:58", "user": { "accountId": 14, "createAt": 1677121742318, "createTime": "2023-02-23 11:09:02", "nickName": "test1111" } }, "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 4 .账号拉新积分明细 `/accountScoreDetails` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ---------------------------------------------------------- | | pageSize | int | 否 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据,默认是10条 | | curIdx | int | 否 | 否 | 当前第几页，默认从0开始 | | token | string | 是 | 是 | 登录成功后获取的令牌 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ```http http://127.0.0.1:7379/new_battle/accountScoreDetails?token=oc904uFv4f&sign=0f6aa27a4e529987d808162e38e731ef×tamp=1676373020000 ``` 返回 ```json { "data": [ { "createAt": 1676623234384, "createTime": "2023-02-17 16:40:34", "dstAccountId": 10, "dstAccountName": "", "dstPoint": 100, "eventDesc": "成功注册增加100积分", "srcAccountId": 10, "srcPoint": 0 } ], "errCode": 0, "errMsg": "Success", "totalSize": 1 } ``` ##### 5. 获取邮箱验证码 `/mailCode` **只有在AWS上的服务器才能有效发送验证码 ,本地服务器由于国内的墙的问题，无法发送邮件** 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | email | string | 是 | 是 | 邮箱地址 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 请求 ```http http://127.0.0.1:7379/new_battle/mailCode?email=guoliang@gliangliang.com ``` ```http http://192.168.7.221:7379/new_battle/mailCode?email=guoliang@gliangliang.com ``` 返回 ```json { "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 6. 忘记密码 `/passwordForget` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | account | string | 是 | 是 | 账号名 | | newPwd | string | 是 | 是 | 新密码 | | email | string | 是 | 是 | 邮箱地址 | | emailCode | string | 是 | 是 | 验证码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 请求 ```http http://127.0.0.1:7379/new_battle/passwordForget?account=test1111&newPwd=2&email=guoliang@gliangliang.com&emailCode=0123456789 ``` 返回 ```json { "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 7. 新用户注册 `/accountRegister` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | ---------- | ------ | -------- | ------------ | ----------------------------- | | account | string | 是 | 是 | 账号 | | pwd | string | 是 | 是 | 新密码 | | email | string | 是 | 是 | 邮箱地址 | | emailCode | string | 是 | 是 | 验证码,万能验证码见文档第一章 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | | loginType | int | 是 | 是 | 登录类型，具体见LoginEnum结构 | | inviteCode | string | 否 | 否 | 上级邀请码 | 请求 ```http http://127.0.0.1:7379/new_battle/accountRegister?account=test1111&pwd=12321323&email=guoliang@gliangliang.com&emailCode=0123456789&sign=0f6aa27a4e529987d808162e38e731ef×tamp=1676373020000&loginType=1 ``` ```java account=a1|email=guoliang@gliangliang.com|emailcode=null|logintype=null|pwd=12321323|timestamp=1676373020000| ``` ```java account=a1|email=guoliang@gliangliang.com|emailcode=null|logintype=null|pwd=12321323|timestamp=1676373020000|ad78144c4e331a3e6bb811286247c3ec ``` ```java 58002e207bd66b6390658574e8433fab ``` 返回 ```json { "data": { "account": "test1111", "bindAt": -1, "bindTime": "", "channelId": 3, "createAt": 1677121736738, "createTime": "2023-02-23 11:08:56", "edit": true, "email": "guoliang@gliangliang.com", "id": 14, "inviteCode": "MHVXK00ZBK", "lastLoginAt": 1677121738998, "lastLoginIp": "127.0.0.1", "lastLoginTime": "2023-02-23 11:08:58", "loginType": 0, "nickName": "test1111", "score": 100, "smallWallet": { "address": "0x00000000000000000000000000000000", "createAt": 1677121738056, "createTime": "2023-02-23 11:08:58", "hdIdx": 13, "id": 13 }, "status": 1, "token": "fFRHmZKSoh", "tokenExpireAt": 1677380938998, "tokenExpireTime": "2023-02-26 11:08:58", "user": { "accountId": 14, "createAt": 1677121742318, "createTime": "2023-02-23 11:09:02", "nickName": "test1111" } }, "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 8. 绑定邮箱 `/bindEmail` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | account | string | 是 | 是 | 账号 | | pwd | string | 是 | 是 | 新密码 | | email | string | 是 | 是 | 邮箱地址 | | emailCode | string | 是 | 是 | 验证码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 9.更新性别 `/updateSex` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | gender | int | 否 | 是 | 性别，具体见CocosUserGenderEnum结构 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 返回 ```json { "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 10. 商城购买道具`/itemBuy` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | ----------- | ------ | -------- | ------------ | -------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌 | | itemDictIds | string | 是 | 是 | 道具字典表ID，多个道具用逗号拼接字符串 | | address | string | 是 | 是 | 钱包地址 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 返回 ```json { "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 11.背包数据请求 `/bags` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | itemType | int | 否 | 是 | 道具字典表类型，如果-1代表所有类型道具 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 返回 ##### 12.用户坑位数据请求 `/slots` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | roomId | int | 否 | 是 | 用户ID | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 返回 ##### 13.坑位填装请求 `/slotUpdate` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | slotObjId | int | 否 | 是 | 用户坑位ID | | itemObjId | int | 否 | 是 | 道具实例ID，-1代表不填装任何东西 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | - ​ 如果是更新房间，所有的装饰物件状态会复原到初始状态 - ​ 更新成功后，需要客户端自己重新请求下背包数据接口和SLOT列表 - ​ 物件类型如果是相框，支持相框替换，相框内可以对图片进行自定义上传 - ​ ojbId是-1，则为取消物件装配 - ​ 如果坑位上已经装配了物件，服务器会自动卸载之前物件，替换最新物件装配 返回 ##### 14.给别人点赞 `/thumbUp` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ---------------------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令 | | objId | int | 否 | 是 | 点赞的实例ID | | objType | int | 否 | 是 | 1.房间 2.房间里的slot，包括(画 ,家具) 3.avatar | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 15.给别人取消点赞 `/thumbUpCancel` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | dstUserId | int | 否 | 是 | 被点赞的 用户ID | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | | | | ##### 16.请求关注别人 ` /followOther` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | dstUserId | int | 否 | 是 | 被点赞的 用户ID | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 17.取消关注别人 ` /followOtherCancel` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | dstUserId | int | 否 | 是 | 被点赞的 用户ID | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 18.自己的关注列表 ` /followingList` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | userId | int | 否 | 是 | 实例ID | | pageSize | int | 是 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 是 | 否 | 当前第几页，默认从0开始 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 19. 自己的粉丝列表 ` /followersList` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | userId | int | 否 | 是 | 实例ID | | pageSize | int | 是 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 是 | 否 | 当前第几页，默认从0开始 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 20.热门用户推荐列表 ` /recommendList` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | pageSize | int | 是 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 是 | 否 | 当前第几页，默认从0开始 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 21. 留言列表 ` /commentList` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌 | | roomId | int | 是 | 是 | 实例ID | | slotObjId | int | 是 | 是 | 留言在特定坑位上 | | pageSize | int | 是 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 是 | 否 | 当前第几页，默认从0开始 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 22.留言提交 ` /commentSubmit` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌 | | roomId | int | 是 | 是 | 实例ID | | slotObjId | int | 是 | 是 | 留言在特定坑位上 | | content | string | 是 | 否 | 留言内容 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### ~~23.留言回复 ` /commentAnswer`~~ ~~请求~~ | ~~参数名~~ | ~~类型~~ | ~~可否为空~~ | ~~是否参与加密~~ | ~~说明~~ | | ---------------- | ---------- | ------------ | ---------------- | ------------------------------------ | | ~~token~~ | ~~string~~ | ~~否~~ | ~~是~~ | ~~登录成功后获取的令牌~~ | | ~~commentObjId~~ | ~~int~~ | ~~否~~ | ~~是~~ | ~~留言实例ID，即针对这条留言的回复~~ | | ~~dstUserId~~ | ~~int~~ | ~~否~~ | ~~是~~ | ~~给这个人留言~~ | | ~~content~~ | ~~string~~ | ~~否~~ | ~~否~~ | ~~留言内容~~ | | ~~sign~~ | ~~string~~ | ~~否~~ | ~~否~~ | ~~md5加密值~~ | | ~~timestamp~~ | ~~string~~ | ~~是~~ | ~~是~~ | ~~时间戳 毫秒~~ | ##### 24. 修改密码 `/passwordUpdate` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | account | string | 是 | 是 | 账号名 | | oldPwd | string | 是 | 是 | 老密码 | | newPwd | string | 是 | 是 | 新密码 | | email | string | 是 | 是 | 邮箱地址 | | emailCode | string | 是 | 是 | 验证码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 请求 ```http http://127.0.0.1:7379/new_battle/passwordUpdate?account=test1111&newPwd=2&oldPwd=1&email=guoliang@gliangliang.com&emailCode=0123456789 ``` 返回 ```json { "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 25.用户信息 `/cocosUserInfo` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 26.玩家房间信息 `/cocosUserRoomInfo` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ---------------- | | roomId | int | 是 | 是 | 要看的房间实例ID | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 27.修改昵称 `/cocosUserNickNameUpdate` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | nickName | string | 是 | 是 | 新的昵称 | | sign | string | 是 | 否 | md5加密值 | | roomId | int | 是 | 是 | 房间id | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 28.上传图片`/uploadImg` 游戏目录 `/game/website/afh5/1.0.1/meta/game/head` 存放大象头像 url : https://dev.ic1101.top/meta/game/head/100001.png `/game/website/afh5/1.0.1/meta/game/icon` 存放类似huangguan这样的UI图标 url : https://dev.ic1101.top/meta/game/icon/huangg.png `/game/website/afh5/1.0.1/meta/game/item ` 存放待会有 url : https://dev.ic1101.top/meta/game/item/300001.jpg 道具 用户自定义上传目录 `/game/website/afh5/1.0.1/meta/player/default/` 默认存放的根目录地址 url : https://dev.ic1101.top/meta/player/default/1.png `/game/website/afh5/1.0.1/meta/player/pic/` 用户上传的画册图片 url : https://dev.ic1101.top/meta/player/pic/1.png `/game/website/afh5/1.0.1/meta/player/head/` 用户上传的子定义头像图片 url : https://dev.ic1101.top/meta/player/head/1.png 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | picName | string | 是 | 是 | 新的昵称 | | fileType | string | 是 | 是 | pic : 用户画册 head:头像 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 29. slot修改名字 `/cocosUserSlotNameUpdate` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | slotObjId | int | 是 | 是 | slot实例ID | | slotName | string | 是 | 是 | 新的昵称 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 30. slot添加图片 `/cocosUserSlotImgUpdate` - 只针对相框类型的slot可以更改图片，type类型90 - imgUrl从上传图片`/uploadImg` 接口返回 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | slotObjId | int | 是 | 是 | slot实例ID | | imgUrl | string | 是 | 是 | 资源路径 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 31.退出游戏 `/cocosUserLogout` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 32.gpt聊天 `/gptChat` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | | content | string | 是 | 是 | 聊天内容 | ##### 0309会议后服务器接口更新日志 - 注册时候增加邀请码填写（非必填） `/accountRegister` - 增加修改昵称接口 `/cocosUserNickNameUpdate` - 上传图片接口 `/uploadImg` - 去掉留言回复接口 `/commentAnswer` - 新注册用户会自动创建10个相框，在slot列表里返回，slotType为8 - 坑位填装请求 `/slotUpdate` ​ 1） 如果是更新房间，所有的装饰物件状态会复原到初始状态 ​ 2） 更新成功后，需要客户端自己重新请求下背包数据接口和SLOT列表 ​ 3） 物件类型如果是相框，支持相框替换，相框内可以对图片进行自定义上传 ​ 4）ojbId是-1，则为取消物件装配 ​ 5）如果坑位上已经装配了物件，服务器会自动卸载之前物件，替换最新物件装配 - slot对象增加用户修改名字，只有用户自定义相片才可以修改SLOT名字 `/cocosUserSlotNameUpdate` - 新增加给相框里添加图片接口 `/cocosUserSlotImgUpdate` - 留言提交接口 留言提交 ` /commentSubmit` 新增加slotDictId参数 支持对特定坑位上的物件留言 - 留言列表 ` /commentList`接口新增加slotDictId参数 查看指定物件的留言列表 ##### 33 .我是否关注过指定人 `/cocosUserIsWatch` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | dstUserId | int | 是 | 是 | 目标用户 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 34 .查询某人是否为游客 `/cocosUserIsGuest` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | dstUserId | int | 是 | 是 | 目标用户 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 35 . 声音白名单 `/VoiceWhiteListServlet` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 36 . 领取奖励 `/cocosUserGetPrize` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------------------- | | token | string | 是 | 是 | 登录成功后获取的令牌，不传TOKEN 就是游客模式 | | roomId | int | 是 | 是 | 领取奖励的房间ID | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | #### 四.金币奖励规则 1. 新人注册赠送100金币 #### 五.CRM接口 ##### 1.官网新用户注册日志 `demoDayRegisterLogs` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------------- | ------ | -------- | ------------ | ----------------------------------------------- | | pageSize | int | 否 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 否 | 否 | 当前页 默认是0开始 | | channelId | int | 否 | 否 | 区分账密还是游客，不传是所有 | | accountType | int | 否 | 否 | 账号类型 1,.cocos 2.ue5 不传就是所有 | | registerStartAt | string | 否 | 否 | 注册开始时间 | | registerEndAt | string | 否 | 否 | 注册截止时间 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 2.实时用户在线数（不含UE5） `demoDayOnlineUsers` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 3.每日登录日志 `DemoDayLogins` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | pageSize | int | 否 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 否 | 否 | 当前页 默认是0开始 | | loginType | int | 否 | 否 | 账号类型 1,.cocos 2.ue5 不传就是所有 | | startAt | string | 否 | 否 | 开始时间 | | endAt | string | 否 | 否 | 截止时间 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 4.邀请码使用情况 `inviteCodeLogs` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | pageSize | int | 否 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 否 | 否 | 当前页 默认是0开始 | | startAt | string | 否 | 否 | 开始时间 | | endAt | string | 否 | 否 | 截止时间 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 5.UE5下载码使用情况 `installCodeLogs` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | pageSize | int | 否 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 否 | 否 | 当前页 默认是0开始 | | startAt | string | 否 | 否 | 开始时间 | | endAt | string | 否 | 否 | 截止时间 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 6.邀请码使用次数统计 `inviteCodeStatics` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------------------------------------------- | | pageSize | int | 否 | 否 | 分页的单页最大记录数，-1代表不分页,获取所有数据 | | curIdx | int | 否 | 否 | 当前页 默认是0开始 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 7.PPT强制结束 `pptEndForce` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 8.PPT强制开始 `pptStartForce` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 9.PPT强制跳转到指定页 `pptJumpToForce` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 10.PPT白名单配置表获取 `pptConfigList` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | #### 六.机器人 ##### 1.机器人手动模式和巡航模式切换 `autoTrigger` ```http http://3.0.61.217:8091/new_battle/autoTrigger ``` ##### 2.调整机器人在线数`robotAmountUpdate` ```http http://3.0.61.217:8091/new_battle/robotAmountUpdate?amount=10 ``` ```http http://127.0.0.1:7379/new_battle/robotAmountUpdate?amount=10 ``` ##### 3.机器人自动聊天切换 `robotAutoChatTrigger` ```http http://3.0.61.217:8091/new_battle/robotAutoChatTrigger ``` ```http http://127.0.0.1:7379/new_battle/robotAutoChatTrigger ``` ##### 4.机器人自动发表情切换 `robotAutoEmoTrigger` ```http http://3.0.61.217:8091/new_battle/robotAutoEmoTrigger ``` ```http http://127.0.0.1:7379/new_battle/robotAutoEmoTrigger ``` ##### 5.机器人自动点赞切换 `robotAutoThumpTrigger` ```http http://3.0.61.217:8091/new_battle/robotAutoThumpTrigger ``` ```http http://127.0.0.1:7379/new_battle/robotAutoThumpTrigger ``` ##### 5.机器人自动移动切换 `robotAutoMoveTrigger` ```http http://3.0.61.217:8091/new_battle/robotAutoMoveTrigger ``` ```http http://127.0.0.1:7379/new_battle/robotAutoMoveTrigger ``` ##### 6.机器人自动跳跃切换 `robotAutoJumpTrigger` ```http http://3.0.61.217:8091/new_battle/robotAutoJumpTrigger ``` ```http http://127.0.0.1:7379/new_battle/robotAutoJumpTrigger ``` ##### 7.机器人手动发言 `robotChatSend` ```http http://3.0.61.217:8091/new_battle/robotChatSend?amount=10&chat=yyds ``` ```http http://127.0.0.1:7379/new_battle/robotChatSend?amount=10&chat=yyds ``` ##### 8.设置最高在线数 `maxOnlineSet` ```http http://3.0.61.217:8091/new_battle/maxOnlineSet?amount=10 ``` ```http http://127.0.0.1:7379/new_battle/maxOnlineSet?amount=10 ``` #### 七.国服版本开发 ##### 1.手机验证码获取 `/zhSmsCode` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | mobile | string | 是 | 是 | 手机号 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ```http http://127.0.0.1:7379/new_battle/zhSmsCode?mobile=13816510467 ``` ##### 2.国服登录`/zhLogin` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ------------------- | | mobile | string | 是 | 是 | 手机号 | | type | int | 是 | 是 | 1.验证码 2.密码登录 | | pwd | string | 是 | 是 | 验证码或者密码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 3.绑定邮箱`/zhBindEmail` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 手机号 | | email | string | 是 | 是 | 邮箱 | | emailCode | string | 是 | 是 | 邮箱验证码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 4.重置密码`/zhPwdReset` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | mobile | string | 是 | 是 | 手机号 | | code | string | 是 | 是 | 验证码 | | pwd | string | 是 | 是 | 新的密码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 5.绑定密码 `/zhPwdUpdate` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 手机号 | | pwd | string | 是 | 是 | 新的密码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 6.解绑邮箱`/zhUnbindEmail` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 手机号 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 7.商城购买 `/zhBuyItem` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------- | | token | string | 是 | 是 | 手 | | itemObjId | int | 是 | 是 | 商城道具实例ID | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 8.用户面板信息 `/zhUserPannel` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 手机号 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 9.商城道具 `/zhShopPannel` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 请求 ```http http://192.168.7.231:7379/new_battle/zhShopPannel ``` 返回 ```json { "data": [ { "amount": -1, "createAt": 1689836590798, "createAtDesc": "2023-07-20 15:03:10", "dBName": "CocosShopItemEntity", "dBPath": "CocosShopItemEntity", "desc": "发型（男）", "icon": "100001", "id": 83, "isFirstFree": 1, "isInShop": 1, "itemDictId": 100001, "itemName": "发型（男）", "itemType": 1, "model": "100001", "price": 10, "status": 1, "subType": 100, "updateAt": 1689836590798 } ], "errCode": 0, "errMsg": "Success", "totalSize": 0 } ``` ##### 9.商城金币 `/zhShopGoldPannel` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | 请求 ```http http://192.168.7.231:7379/new_battle/zhShopGoldPannel ``` ##### 10.设置默认房间 `/zhSetDefaultRoom` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 令牌 | | roomId | int | 是 | 是 | 房间号 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 11.房间密码设置 `/zhSetRoomPwd` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 令牌 | | roomId | int | 是 | 是 | 房间号 | | pwd | string | 是 | 是 | 房间密码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 12.房间密码认证 `/zhRoomPwdAuth` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 令牌 | | roomId | int | 是 | 是 | 房间号 | | pwd | string | 是 | 是 | 房间密码 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 12.房间名字修改 `/zhRoomNameUpdate` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 令牌 | | roomId | int | 是 | 是 | 房间号 | | roomName | string | 是 | 是 | 房间名字 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 13.获取自己的avatar列表 `/zhUserAvatars` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 令牌 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 14.设置默认avatar `/zhSetDefaultAvatar` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 令牌 | | avatarId | int | 是 | 是 | avatar | | roomId | int | 是 | 是 | roomId | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 15.商城购车车批量购买 `/zhShopCartBuy` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | ------------ | ------ | -------- | ------------ | ------------- | | token | string | 是 | 是 | 手机号 | | shopCartJson | string | 是 | 是 | json 数据类型 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | shopCartJson 格式如下 ```json [{"itemObjId":1,"amount":10}] ``` ##### 16.用户背包 `/zhUserBag` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | token | string | 是 | 是 | 手机号 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 17.房间slot `/zhRoomSlots` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ----------- | | roomId | int | 是 | 是 | 房间实例ID | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 18.avatar信息 `/zhUserAvatarInfo` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | ------------ | | avatarId | int | 是 | 是 | avatar实例ID | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 19.avatar换装请求 `/zhUserAvatarSlotUpdate` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | roomId | int | 是 | 是 | roomId | | avatarId | int | 是 | 是 | avatar实例ID | | slotObjId | int | 否 | 是 | 用户坑位ID | | itemObjId | int | 否 | 是 | 道具实例ID，-1代表不填装任何东西 | | sign | string | 否 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 20.商城购车价格 `/zhShopCartPrice` | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | ------------ | ------ | -------- | ------------ | ------------- | | token | string | 是 | 是 | 手机号 | | shopCartJson | string | 是 | 是 | json 数据类型 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | shopCartJson 格式如下 ```json [{"itemObjId":1,"amount":10}] ``` ##### 21.创建特殊馆`/zhGmRoomCreate` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | ---------- | ------ | -------- | ------------ | ----------- | | roomObjId | int | 是 | 是 | room实例ID | | roomName | string | 是 | 是 | | | dictItemId | int | 是 | 是 | | | sceneName | string | 是 | 是 | | | icon | string | 是 | 是 | | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 22.获取声网TOKEN`/zhGetShengWangToken` 请求 | 参数名 | 类型 | 是否必填 | 是否参与加密 | 说明 | | ----------- | ------ | -------- | ------------ | ------------- | | token | string | 是 | 是 | 登录后得token | | uid | int | 是 | 是 | uid | | channelName | string | 是 | 是 | channelName | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 23. slot修改描述 `/zhSlotDescUpdate` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | slotObjId | int | 否 | 是 | 用户坑位ID | | desc | string | 否 | 是 | 说明 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 | ##### 24.slot参数修改 `/zhSlotParamUpdate` 请求 | 参数名 | 类型 | 可否为空 | 是否参与加密 | 说明 | | --------- | ------ | -------- | ------------ | -------------------- | | token | string | 否 | 是 | 登录成功后获取的令牌 | | slotObjId | int | 否 | 是 | 用户坑位ID | | scale | double | 否 | 是 | 缩放系数 | | offsetX | double | 否 | 是 | X坐标偏移量 | | offsetY | double | 否 | 是 | Y坐标偏移量 | | sign | string | 是 | 否 | md5加密值 | | timestamp | string | 是 | 是 | 时间戳 毫秒 |