Web authentication API

From Official Factorio Wiki
Revision as of 04:19, 8 January 2017 by Lexxy Fox (talk | contribs)
Jump to navigation Jump to search

Factorio's Web Authentication API endpoint gives you a token in exchange for your username and password, which is used by several other Factorio web API endpoints. The authentication endpoint is located at:

https://auth.factorio.com/api-login

Authentication requires sending an HTTP POST request with these parameters:

username Required. Account username.
password Required. Account password.
api_version Not required. Currently 2.

This endpoint always returns JSON encoded data. If authentication was successful, it will return an HTTP status code of 200 with a JSON list containing a single item: the auth token. The auth token seems to always be a hexadecimal encoded 15-byte string of random bytes.

TODO: exceptions and stuffs.