Factorio HTTP API usage guidelines

From Official Factorio Wiki
Revision as of 09:43, 21 January 2022 by Vinzenz (talk | contribs) (inital guidelines)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

General

Third party clients are welcome to use our HTTP APIs if they provide a benefit to players and creators in the Factorio community. We ask developers to:

  • ensure user privacy, e.g. by properly securing account secrets like passwords or tokens.
  • respect server resources, e.g. by using exponential backoff in case of errors.
  • communicate that their tool/library is in no way sanctioned by Wube Software.

We reserve the right to ban or rate limit abusive clients, IP addresses or accounts. Unless stated otherwise, our APIs should be considered internal.

Categories

Internal

  • These APIs are only supported for use with the official Factorio game clients or websites.
  • Up-to-date documentation is not guaranteed.
  • We strive to support very old Factorio releases, so these APIs won't change much most of the time.

Public

  • These APIs are intended to support developers building integrations with the official Factorio game clients or websites.
  • Documentation will be kept up-to-date.
  • Breaking changes to these APIs are communicated in a reasonable timeframe.

APIs

Internal

Public

Stay tuned...