Matchmaking API
The matchmaking API allows Factorio servers to advertise themselves, and for players to browse open game servers. The matchmaking server currently uses Heroku and Green Unicorn software.
API root: https://multiplayer.factorio.com/
Some of the API endpoints require the use of an authentication token, which is obtained through the Web Authentication API. It is sent as the HTTP parameter named token and encoded using hexadecimal. For GET requests it is sent as part of the URL, and for POST requests it is sent as a POST parameter.
Work in progress! I'm just going to jot down some random notes in the mean time :P
https://multiplayer.factorio.com/create-game
https://multiplayer.factorio.com/post-game-heartbeat/
https://multiplayer.factorio.com/get-games
https://multiplayer.factorio.com/get-game-details/ Unauthenticated
| Key | Type | Endpoints | Description | ||
|---|---|---|---|---|---|
| application_version.build_mode | string | ✓ | ✓ | ✓ | |
| application_version.build_version | string(number) | ✓ | ✓ | ✓ | |
| application_version.game_version | string | ✓ | ✓ | ✓ | |
| application_version.platform | string | ✓ | ✓ | ✓ | |
| description | string | ✓ | ✓ | ||
| game_id | number | ✓ | ✓ | ✓ | |
| game_secret | string | ✓ | |||
| game_time_elapsed | string(number) | ✓ | ✓ | ✓ | |
| has_password | string(boolean) | ✓ | ✓ | ✓ | |
| host_address | string(ip:port) | ✓ | ✓ | ||
| last_heartbeat | number | ✓ | |||
| max_players | string(number) | ✓ | ✓ | ✓ | |
| mod_count | number | ✓ | |||
| mods | mod[] | ✓ | ✓ | ||
| mods_crc | number | ✓ | |||
| name | string | ✓ | ✓ | ✓ | |
| players | string[] | ✓ | ✓ | ||
| require_user_verification | string(boolean) | ✓ | ✓ | ||
| server_id | string | ✓ | ✓ | ||
| tags | string[] | ✓ | ✓ | ||