角色查询
# 接口文档-角色查询
## 说明
### 请求地址
```
发布站域名/api/game/
```
### 请求参数
| 参数 | 说明 | 类型 | 备注 | 是否必填 |
|------|------|--------|---------------|----------|
| type | | string | 固定值：xy.game.role| 是 |
| pid | | string | 商户编号 我方提供 | 是 |
| gid | | int | 我方游戏id | 是 |
| sid | | int | 我方游戏服id | 是 |
| time | | long | 时间戳10位 | 是 |
| uid | | string | 我方用户编号 | 是 |
| gsid | | string | 游戏方游戏服标识 | 否 |
| rolename | | string | 角色名称 | 否 |
| rolenumber | | string | 角色编号 | 否 |
| sign | | string | 签名 | 是 |
#### 签名规则
``` csharp
key 我方提供 只参与加密
签名方法：sign=md5(pid#key#time#type)（转换成小写32位）
说明：md5加密参数值，注意只加密参数值，不带参数名，用英文的#号连接各参数值
例如：加密前：xykj#123456#1547522338#xy.game.role 加密后：466bf908ed6c8d58856526db8e3a3c47
```
##### 返回值
``` json
{
"code": 1,
"msg": "",
"data":[{
"rolename":"角色名", //角色名一定存在其他参数可能没有值
"rolenumber":"角色编号",
"level":"等级",
"professional":"职业",
"conversion":"转生次数",
"coins":"游戏币",
"experience":"游戏经验",
"fighting":"战斗力",
"sex":"性别",
"roledata":"角色信息json",
"money":"角色充值金额",
"createtime":"角色创建时间"
}]
}
```
| code | 说明 |
|--------|------------------------------------------------------------------------------|
| 1 | 成功，data中是角色集合址 |
| 2 | pid参数为空或者错误 |
| 4 | gid参数为空或者游戏不存在或者游戏接口信息不存在 |
| 5 | sid参数为空或者游戏服不存在 |
| 6 | uid参数为空或者uname参数为空 |
| 8 | 该订单已存在 |
| 9 | money参数为空或者不大于0 |
| 11 | sign参数为空或错误 |
| 13 | paytype参数为空 或者该编号的支付方式不存在或者改支付方式的对应支付平台不存在 |
| 23 | 请求的uid账号在vip站不存在 |
| 32 | 游戏服密码错误 |
| 33 | orderid参数为空 |
| 34 | time参数为空 或与服务器时间相差大于五分钟 |
| -1 | 角色验证不通过 |
| 0 | 其他错误 具体错误信息在msg参数中 |