Download API - Revision history

Chaoswolf: Add new `expansion` string for `build` parameter

2024-10-29T15:01:07Z

Add new `expansion` string for `build` parameter

← Older revision		Revision as of 15:01, 29 October 2024
Line 27:		Line 27:
	* Where {version} is the version string of the release you wish to grab - e.g. "0.15.31". Use "latest" instead to default to the latest version for that build.		* Where {version} is the version string of the release you wish to grab - e.g. "0.15.31". Use "latest" instead to default to the latest version for that build.
	* {build} is the release build, which currently comprises of:		* {build} is the release build, which currently comprises of:
	** <code>alpha</code> - the current standard full-featured build.		** <code>alpha</code> - the current standard full-featured build without the space age expansion.
			** <code>expansion</code> - the current standard full-featured build with the space age expansion.
	** <code>demo</code> - the free, publicly accessible demo versions.		** <code>demo</code> - the free, publicly accessible demo versions.
	** <code>headless</code> - for running servers on machines without graphical interface.		** <code>headless</code> - for running servers on machines without graphical interface.

Chaoswolf: Add cURL download example using the authentication token

2024-09-11T19:30:00Z

Add cURL download example using the authentication token

← Older revision		Revision as of 19:30, 11 September 2024
Line 42:		Line 42:

	Note: Windows 32 bit and 64 bit installers are [https://en.wikipedia.org/wiki/Inno_Setup Inno Setup] formatted packages (I'll document that somewhere someday).		Note: Windows 32 bit and 64 bit installers are [https://en.wikipedia.org/wiki/Inno_Setup Inno Setup] formatted packages (I'll document that somewhere someday).

			=== Using cURL to download Factorio ===

			Another way to download factorio is by sending a HTTP GET request with <code>username</code> and <code>token</code> parameters to the download URL.
			The authentication token can be found on the factorio website after logging into your account.
			Note that the authentication token is a sensitive piece of information and should be kept secret.

			The cURL command would look like:

			<code>curl https://www.factorio.com/get-download/{version}/{build}/{distro}?username={username}&token={token} -L --output /path/to/output/directory/factorio.tar.xz</code>

			And here is a filled in example:

			<code>curl https://www.factorio.com/get-download/0.15.31/alpha/linux64?username=exampleUser&token=0123456789abcdef -L --output /tmp/factorio.tar.xz</code>

	== Version Listings ==		== Version Listings ==

Ickputzdirwech: Removed {{Languages}}

2023-11-12T09:04:34Z

Removed {{Languages}}

← Older revision		Revision as of 09:04, 12 November 2023
Line 66:		Line 66:
	A list of available update packages is provided at <code>https://updater.factorio.com/get-available-versions</code>.		A list of available update packages is provided at <code>https://updater.factorio.com/get-available-versions</code>.

	~~{{Languages}}~~[[Category:Technical]]		[[Category:Technical]]

Bilka at 09:58, 25 February 2022

2022-02-25T09:58:26Z

← Older revision		Revision as of 09:58, 25 February 2022
Line 1:		Line 1:
	<div align="center">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal\|Internal API]]</div>		<div align="center" class="stub">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal\|Internal API]]</div>

	This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)		This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)

Bilka: word

2022-02-25T09:54:48Z

word

← Older revision		Revision as of 09:54, 25 February 2022
Line 1:		Line 1:
	<div align="center">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal\|~~internal~~ API]]</div>		<div align="center">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal\|Internal API]]</div>

	This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)		This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)

Bilka: Better format for API category

2022-02-25T09:54:34Z

Better format for API category

← Older revision		Revision as of 09:54, 25 February 2022
Line 1:		Line 1:
	'''Category:''' [~~https://wiki.factorio.com/~~Factorio_HTTP_API_usage_guidelines#Internal internal]		<div align="center">'''Category:''' [[Factorio_HTTP_API_usage_guidelines#Internal\|internal API]]</div>

	This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)		This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)

Vinzenz: add category

2022-01-21T09:45:27Z

add category

← Older revision		Revision as of 09:45, 21 January 2022
Line 1:		Line 1:
			'''Category:''' [https://wiki.factorio.com/Factorio_HTTP_API_usage_guidelines#Internal internal]

	This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)		This API allows you to download official releases of stand-alone Factorio from the Factorio servers. It's not so much of an API as it is web scraping, but it's documented here for completeness. Please update this page if you utilize it and the information becomes outdated. Also note that's there's a separate, (semi)official API for upgrading between releases, which should be used when possible to lighten the load on the Factorio servers. (I'll document that later, promise!)

Vince: /* Version Listings */

2020-08-12T09:28:59Z

Version Listings

← Older revision		Revision as of 09:28, 12 August 2020
Line 50:		Line 50:
	Note: This endpoint require an authenticated session as mentioned above.		Note: This endpoint require an authenticated session as mentioned above.

	You could the grab all the informations you need by parsing the HTML using selectors but I would recommend only searching for the pattern <code>href="/get-download/*"</code> and then parse the relative link according to the "/get-download/{version}/{build}/{distro}" structure described in the section above. The second method has a clear advantage of reliability through potential HTML structure changes and simplicity.		You could the grab all the informations you need by parsing the HTML using selectors but I would recommend only searching for the pattern <code>href="/get-download/*"</code> and then parse the relative link according to the <code>/get-download/{version}/{build}/{distro}</code> structure described in the section above. The second method has a clear advantage of reliability through potential HTML structure changes and simplicity.

	It is also better to rely on the <code>https://factorio.com/api/latest-releases</code> endpoint and version number comparisons to distinguish between stable and experimental versions than to extract that information from the download HTML page with selectors.		It is also better to rely on the <code>https://factorio.com/api/latest-releases</code> endpoint and version number comparisons to distinguish between stable and experimental versions than to extract that information from the download HTML page with selectors.

Vince: /* Version Listings */

2020-08-12T09:18:50Z

Version Listings

← Older revision		Revision as of 09:18, 12 August 2020
Line 44:		Line 44:
	There is an API endpoint to find the latest version number at <code>https://factorio.com/api/latest-releases</code>. This can be polled to automatically detect when a new update was released.		There is an API endpoint to find the latest version number at <code>https://factorio.com/api/latest-releases</code>. This can be polled to automatically detect when a new update was released.

	~~Furthermore~~, ~~you can grab a list of~~ Factorio versions available ~~for download by sending a GET request to~~ the ~~endpoint~~ at		Due to changes in the Factorio website, all Factorio versions are now available on the HTML page at this location:

	<code>https://www.factorio.com/download</code>		<code>https://www.factorio.com/download/archive</code>

			Note: This endpoint require an authenticated session as mentioned above.

	~~Experimental releases have their own page, which~~ has ~~the same interface,~~ and ~~can be found at:~~		You could the grab all the informations you need by parsing the HTML using selectors but I would recommend only searching for the pattern <code>href="/get-download/*"</code> and then parse the relative link according to the "/get-download/{version}/{build}/{distro}" structure described in the section above. The second method has a clear advantage of reliability through potential HTML structure changes and simplicity.

	<code>https://~~www.~~factorio.com/~~download~~/~~experimental~~</code>		It is also better to rely on the <code>https://factorio.com/api/latest-releases</code> endpoint and version number comparisons to distinguish between stable and experimental versions than to extract that information from the download HTML page with selectors.

	~~There is also another endpoint available that filters to only~~ headless releases. ~~(Does not contain~~ experimental releases)		The previous endpoints for experimental and headless releases <code>https://www.factorio.com/download/experimental</code> and <code>https://www.factorio.com/download-headless</code> now both redirect to this page containing only the latest releases:

	<code>https://www.factorio.com/download~~-headless~~</code>		<code>https://www.factorio.com/download</code>

	~~Then a list of~~ version ~~number~~ and build combinations ~~can be grabbed by using either of the selectors:~~		The selectors used to retrieve version numbers and build combinations are presented below, but they are probably obsolete. I will check them later and update this section accordingly.
	* CSS1: <code>h3</code>		* CSS1: <code>h3</code>
	* XPATH1: <code>//h3</code>		* XPATH1: <code>//h3</code>

	~~Alternatively, you can skip straight to selecting all of the download links, and parsing out the version numbers and such from there. (I actually recommend this method)~~
	* CSS1: <code>body>div>ul a</code> (and then take the "href" attribute)
	* XPATH1: <code>//body/div/ul//a/@href</code>

	A list of available update packages is provided at <code>https://updater.factorio.com/get-available-versions</code>.		A list of available update packages is provided at <code>https://updater.factorio.com/get-available-versions</code>.

	{{Languages}}[[Category:Technical]]		{{Languages}}[[Category:Technical]]

Bitbyte: /* Downloading */

2020-07-09T15:47:34Z

Downloading

← Older revision		Revision as of 15:47, 9 July 2020
Line 23:		Line 23:
	<code>https://www.factorio.com/get-download/{version}/{build}/{distro}</code>		<code>https://www.factorio.com/get-download/{version}/{build}/{distro}</code>

	* Where {version} is the version string of the release you wish to grab - e.g. "0.15.31".		* Where {version} is the version string of the release you wish to grab - e.g. "0.15.31". Use "latest" instead to default to the latest version for that build.
	* {build} is the release build, which currently comprises of:		* {build} is the release build, which currently comprises of:
	** <code>alpha</code> - the current standard full-featured build.		** <code>alpha</code> - the current standard full-featured build.