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
		get-games	details	create
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[]		✓	✓