> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Requests and responses

> v1 API URLs, headers, parameter format, time format and the common response structure.

## Request URL

```text theme={null}
{host}/{action}
```

* `{host}` is the API domain we provide.
* Example: `{host}/api/v1.0/member/create`

## Parameter format

* `GET` and `DELETE`: pass parameters in the query string.
* Other methods: send parameters as `multipart/form-data`.

## Headers

Every request must include the headers below. For services we provide, you send the token; for services you provide, you verify the token we send.

| Header | Value | Description |
| - | - | - |
| `Authorization` | Token | Required on all methods |
| `Content-Type` | `multipart/form-data` | Required on all methods except `GET` and `DELETE` |

## Connection

Send us the IPs of the servers that call the API.

## API rules

* Accounts under different channels are treated as **different** members. For example, `Player001` in channel-1 and `Player001` in channel-2 are different members in our system.
* Channel IDs range from `1` to `2147483647`.
* Each member session is a single, independent connection identified by its own token.
* While a member plays, the game client refreshes the member's balance on screen, and checks the balance before every bet.
* If a member is idle (places no bets) for more than **5 minutes**, we close the connection.
* A member can hold wallets in multiple currencies. Balances **cannot** be transferred between currencies.
* Some APIs are rate limited. The limit is stated in each API's notes; no note means no limit.

### Time format

Unless an API states otherwise, times use **RFC3339**, precise to the **millisecond** and including the **time zone**:

```text theme={null}
2022-01-01T00:00:00.000+08:00
```

If a time field in a response has no value yet, it is `null`. For example, in [Get event prize information](https://doc.va777.net/en/v1/api-reference/info/activity-rank.md), `prizePayoutTime` is `null` until the prize is paid out.

## Response format

The HTTP status code is always `200`. Every response contains `status`; check `status.code` for the result.

**status** `object` *required*

Processing status of the request.

**Properties**

**code** `string` *required*

Response code. See [Response codes](https://doc.va777.net/en/v1/reference/response-codes.md).

**message** `string` *required*

Response message describing the result.

**datetime** `string` *required*

Time the request was received, in RFC3339.

**traceCode** `string` *required*

Unique trace code for matching responses on both sides.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.