Web authentication API: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 8: | Line 8: | ||
{| class="wikitable" | {| class="wikitable" | ||
| username | | username | ||
| Required. | |||
| Account username. | | Account username. | ||
|- | |- | ||
| password | | password | ||
| Required. | |||
| Account password. | | Account password. | ||
|- | |||
| api_version | |||
| Not required. | |||
| Currently 2. | |||
|} | |} | ||
Revision as of 04:19, 8 January 2017
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.