# <font >查询玩家信息</font>

## 请求地址
>{API_URL}

## 请求参数

| 字段名称 | 类型   | 长度 | 必要 | 描述                  |
| -------- | ------ | ---- | ---- | --------------------- |
| itype    | string | 4    | 是   | 8 = 是查询玩家消息标识 |
| authcode | string | 32   | 是   | 代理标识，由厂商配发  |
| authkey  | string | 32   | 是   | 代理秘钥，由厂商配发  |
| account  | string | 32   | 是   | 玩家账号              |

## 示例

- **URL**:
    - {API_URL}

- **HTTP Method**（请求方式）:
    - `POST`

- **表单数据**:
    > Content-Type: `application/x-www-form-urlencoded`
  
    ```
	itype: 8,
	authcode: test001,
	authkey: 123456,
	account: 0166306192
    ```
	
## 返回结果

|字段名称	| 类型	|    长度	   		 	|说明									|	
|    ----------       |      ----------     |       ----------    |	             ----------                       |
| ret			|int	|4		|-1 表示成功，非 -1 表示失败						|	
| account		|string	|32		|玩家登陆账号                                 |
| name			|string	|32		|用户真名                                    |
| regtime		|string	|32		|注册时间                                    |
| ingot			|double	|19		|奖励码                                      |
| score			|double	|19		|用户分数                                    |
| onlinestatus	|int	|4		|用户状态： 0 = 离线， 1 = 在大厅， 2 = 在游戏中             |
| memo			|string	|128	|备注                                        |
| state			|int	|4		|账号状态： 0 = 没封号， -1 = 封号                              |
| regip			|string	|16		|注册 IP                                     |
| loginlasttime	|string	|255	|最后登录时间                                 |
| loginip		|string	|16		|登录 IP                                     |
| remark		|string	|255	|后台针对该玩家的备注信息            |

## 返回格式

```
{
    "ret": -1,
    "account": "0148161327",
    "name": "",
    "regtime": "2022-10-20 13:48:07.033",
    "ingot": "1.05",
    "score": "168465.66",
    "onlinestatus": "0",
    "memo": "",
    "state": "0",
    "regip": "127.0.0.1",
    "loginlasttime": "1970-01-01 08:00:00.000",
    "loginip": "127.0.0.1",
    "remark": "11111111111111111111111111111111"
}
```