# <font>Query Player Info</font>

## Request URL
> {API_URL}

## Request Parameters

| Field Name | Type   | Length | Required | Description                                     |
|------------|--------|--------|----------|-------------------------------------------------|
| itype      | string | 4      | Yes      | 8 = Indicates player information query request  |
| authcode   | string | 32     | Yes      | Agent identifier, assigned by the provider      |
| authkey    | string | 32     | Yes      | Agent secret key, assigned by the provider      |
| account    | string | 32     | Yes      | Player account                                  |

## Example

- **URL**:  
    - {API_URL}

- **HTTP Method**:  
    - `POST`

- **Form Data**:  
    > Content-Type: `application/x-www-form-urlencoded`

    ```
    itype: 8,
    authcode: test001,
    authkey: 123456,
    account: 0166306192
    ```

## Response Fields

| Field Name       | Type   | Length | Description                                              |
|------------------|--------|--------|----------------------------------------------------------|
| ret              | int    | 4      | -1 indicates success; other than -1 indicates failure    |
| account          | string | 32     | Player login account                                     |
| name             | string | 32     | Player real name                                         |
| regtime          | string | 32     | Registration time                                        |
| ingot            | double | 19     | Bonus code / ingot amount                                |
| score            | double | 19     | Player score                                             |
| onlinestatus     | int    | 4      | Player status: 0 = Offline, 1 = In Lobby, 2 = In Game    |
| memo             | string | 128    | Notes                                                    |
| state            | int    | 4      | Account status: 0 = Active, -1 = Banned                  |
| regip            | string | 16     | Registration IP address                                  |
| loginlasttime    | string | 255    | Last login time                                          |
| loginip          | string | 16     | Last login IP address                                    |
| remark           | string | 255    | Operator remarks on player                               |

## Response Format

```
{
    "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"
}
```