Revision Difference
Global.HTTP#549733
<function name="HTTP" parent="Global" type="libraryfunc">
<description>
Launches an asynchronous http request with the given parameters.
⤶
<bug issue="2232">This cannot send or receive multiple headers with the same name.</bug>
⤶
<bug issue="4133">This function fails with an `invalid url` error if the substring `"10."` appears anywhere in the URL, when `-allowlocalhttp` is not active. Where possible, this can be worked around by encoding the `.` character as `%2E`.</bug>
⤶
<note>HTTP-requests to destinations on private networks (such as `192.168.0.1`) won't work.<br/>⤶
To enable HTTP-requests to destinations on private networks use <page>Command Line Parameters</page> `-allowlocalhttp`.</note>⤶
Launches an asynchronous http request with the given parameters.
⤶
<bug issue="2232">This cannot send or receive multiple headers with the same name.</bug>
<bug issue="4133">This function fails with an `invalid url` error if the substring `"10."` appears anywhere in the URL, when `-allowlocalhttp` is not active. Where possible, this can be worked around by encoding the `.` character as `%2E`.</bug>
<note>HTTP-requests that respond with a large body may return an `unsuccessful` error. Try using the [Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range) header to download the file in chunks.</note>⤶
<note>⤶
HTTP-requests to destinations on private networks (such as `192.168.0.1`) won't work.⤶
<br/>⤶
To enable HTTP-requests to destinations on private networks use <page>Command Line Parameters</page> `-allowlocalhttp`.⤶
</note>⤶
</description>
<realm>Shared and Menu</realm>
<args>
<arg name="parameters" type="table">The request parameters. See <page>Structures/HTTPRequest</page>.</arg>⤶
⤶
<realm>Shared and Menu</realm>
⤶
<args>
<arg name="parameters" type="table">The request parameters. See <page>Structures/HTTPRequest</page>.⤶
</arg>⤶
</args>
<rets>
⤶
<rets>
<ret name="" type="boolean">`true` if we made a request, `nil` if we failed.</ret>
</rets>
</function>