mirror of
https://github.com/openfrontio/OpenFrontIO.git
synced 2026-06-21 22:31:55 +00:00
evanpelle
111 lines
2.1 KiB
Markdown
111 lines
2.1 KiB
Markdown
## API Usage
|
|
|
|
### List Game Metadata
|
|
|
|
Get game IDs and basic metadata for games that started within a specified time range. Results are sorted by start time and paginated.
|
|
|
|
**Constraints:**
|
|
|
|
- Maximum time range: 2 days
|
|
- Maximum limit per request: 1000 games
|
|
|
|
**Endpoint:**
|
|
|
|
```
|
|
GET https://api.openfront.io/public/games
|
|
```
|
|
|
|
**Query Parameters:**
|
|
|
|
- `start` (required): ISO 8601 timestamp
|
|
- `end` (required): ISO 8601 timestamp
|
|
- `type` (optional): Game type, must be one of `[Private, Public, Singleplayer]`
|
|
- `limit` (optional): Number of results (max 1000, default 50)
|
|
- `offset` (optional): Pagination offset
|
|
|
|
**Example Request:**
|
|
|
|
```bash
|
|
curl "https://api.openfront.io/public/games?start=2025-10-25T00:00:00Z&end=2025-10-26T23:59:59Z&type=Singleplayer&limit=10&offset=5"
|
|
```
|
|
|
|
**Response:**
|
|
|
|
```json
|
|
[
|
|
{
|
|
"game": "ABSgwin6",
|
|
"start": "2025-10-25T00:00:10.526Z",
|
|
"end": "2025-10-25T00:19:45.187Z",
|
|
"type": "Singleplayer",
|
|
"mode": "Free For All",
|
|
"difficulty": "Medium"
|
|
},
|
|
...
|
|
]
|
|
```
|
|
|
|
The response includes a `Content-Range` header indicating pagination (e.g., `games 5-15/399`).
|
|
|
|
---
|
|
|
|
### Get Game Info
|
|
|
|
Retrieve detailed information about a specific game.
|
|
|
|
**Endpoint:**
|
|
|
|
```
|
|
GET https://api.openfront.io/public/game/:gameId
|
|
```
|
|
|
|
**Query Parameters:**
|
|
|
|
- `turns` (optional): Set to `false` to exclude turn data and reduce response size
|
|
|
|
**Examples:**
|
|
|
|
```bash
|
|
# Full game data
|
|
curl "https://api.openfront.io/public/game/ABSgwin6"
|
|
|
|
# Without turn data
|
|
curl "https://api.openfront.io/public/game/ABSgwin6?turns=false"
|
|
```
|
|
|
|
**Note:** Public player IDs are stripped from game records for privacy.
|
|
|
|
---
|
|
|
|
### Get Player Info
|
|
|
|
Retrieve information and stats for a specific player.
|
|
|
|
**Endpoint:**
|
|
|
|
```
|
|
GET https://api.openfront.io/public/player/:playerId
|
|
```
|
|
|
|
**Example:**
|
|
|
|
```bash
|
|
curl "https://api.openfront.io/public/player/HabCsQYR"
|
|
```
|
|
|
|
### Get Player Sessions
|
|
|
|
Retrieve a list of games & client ids (session ids) for a specific player.
|
|
|
|
**Endpoint:**
|
|
|
|
```
|
|
GET https://api.openfront.io/public/player/:playerId/sessions
|
|
```
|
|
|
|
**Example:**
|
|
|
|
```bash
|
|
curl "https://api.openfront.io/public/player/HabCsQYR/sessions"
|
|
```
|