Http request - Revision history

Wulfie Reanimator at 23:36, 23 May 2025

2025-05-23T23:36:35Z

← Older revision		Revision as of 16:36, 23 May 2025
Line 12:		Line 12:
	* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.		* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.
	* There is a limit of 64 pending http_request		* There is a limit of 64 pending http_request
	** Be mindful of the event queue in general as well. http_request events may be discarded if your script's queue is filled by other events, such as incoming [[listen]] messages.		** Be mindful of the event queue (64) in general as well. http_request events may be discarded if your script's queue is filled by other events, such as incoming [[listen]] messages.
	* {{LSLP\|body}} is not sent with the request unless the method is set to <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, or [[URL_REQUEST_GRANTED]].		* {{LSLP\|body}} is not sent with the request unless the method is set to <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, or [[URL_REQUEST_GRANTED]].
	* Requests may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code] for at least two possible reasons:		* Requests may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code] for at least two possible reasons:

Wulfie Reanimator: Note about pending events.

2025-05-23T23:32:16Z

Note about pending events.

← Older revision		Revision as of 16:32, 23 May 2025
Line 12:		Line 12:
	* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.		* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.
	* There is a limit of 64 pending http_request		* There is a limit of 64 pending http_request
			** Be mindful of the event queue in general as well. http_request events may be discarded if your script's queue is filled by other events, such as incoming [[listen]] messages.
	* {{LSLP\|body}} is not sent with the request unless the method is set to <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, or [[URL_REQUEST_GRANTED]].		* {{LSLP\|body}} is not sent with the request unless the method is set to <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, or [[URL_REQUEST_GRANTED]].
	* Requests may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code] for at least two possible reasons:		* Requests may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code] for at least two possible reasons:

Jenna Huntsman: Add notes about LSL http pipelines.

2022-06-29T21:35:51Z

Add notes about LSL http pipelines.

← Older revision		Revision as of 14:35, 29 June 2022
Line 9:		Line 9:
	\|caveats=		\|caveats=
	* {{LSLP\|body}} is [[limit]]ed to 2048 bytes; anything longer will be truncated to 2048 bytes.		* {{LSLP\|body}} is [[limit]]ed to 2048 bytes; anything longer will be truncated to 2048 bytes.
			** As per the above, this function is unaffected by any values passed to [[llHTTPRequest]] via [[HTTP_BODY_MAXLENGTH]], as they reside on the [[:Category:LSL HTTP#Understanding_LSL_HTTP_Communications \| Outgoing]] pipeline, and this function is on the [[:Category:LSL HTTP#Understanding_LSL_HTTP_Communications \| Incoming]] pipeline.
	* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.		* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.
	* There is a limit of 64 pending http_request		* There is a limit of 64 pending http_request

Oz Linden at 20:54, 16 April 2018

2018-04-16T20:54:19Z

← Older revision		Revision as of 13:54, 16 April 2018
Line 12:		Line 12:
	* There is a limit of 64 pending http_request		* There is a limit of 64 pending http_request
	* {{LSLP\|body}} is not sent with the request unless the method is set to <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, or [[URL_REQUEST_GRANTED]].		* {{LSLP\|body}} is not sent with the request unless the method is set to <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, or [[URL_REQUEST_GRANTED]].
	* Requests ~~made at approx 0625 SLT~~ may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code]~~, with~~ <code>ERROR: The requested URL could not be retrieved</code>, and <code>(111) Connection refused</code> ~~in the body of the response. This has been confirmed as expected behaviour by [[User:Kelly Linden\|Kelly]]~~, ~~due to~~ the nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.		* Requests may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code] for at least two possible reasons:
			** if the returned body is <code>ERROR: The requested URL could not be retrieved</code>, and <code>(111) Connection refused</code>, the problem will normally last only a few minutes - this is th nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.
			** this response can also happen if too many requests are received by scripts in the region owned by the same owner. In this case, a Retry-After header is returned with a number of seconds to wait before retrying. Note that if you have many requestors, some of them may have to wait longer. A good general strategy is to wait the suggested number of seconds (possibly with a little randomness added in) before retrying, and if that fails increase how long you wait by multiplying by a small number before retrying again. If all your requestors follow some method like this, eventually they'll get through.
	\|examples=		\|examples=
	See [[LSL_http_server/examples]] for some examples from the feature design phase.		See [[LSL_http_server/examples]] for some examples from the feature design phase.

Lady Sumoku: Replaced old block with

2015-01-22T08:35:13Z

Replaced old <LSL> block with <source lang="lsl2">

← Older revision		Revision as of 01:35, 22 January 2015
Line 16:		Line 16:
	See [[LSL_http_server/examples]] for some examples from the feature design phase.		See [[LSL_http_server/examples]] for some examples from the feature design phase.
	{{LSL Tip\|Never ever forget to release a URL again which you have requested! URLs are region resources just like prims. If you take them all you can get into big trouble with the sim owner and/or estate managers.}}		{{LSL Tip\|Never ever forget to release a URL again which you have requested! URLs are region resources just like prims. If you take them all you can get into big trouble with the sim owner and/or estate managers.}}
	<~~lsl~~>		<source lang="lsl2">
	string url;		string url;
	key urlRequestId;		key urlRequestId;
Line 120:		Line 120:
	}		}
	}		}
	</~~lsl~~>		</source>
	\|helpers		\|helpers
	\|also_articles		\|also_articles

Strife Onizuka at 04:45, 10 January 2014

2014-01-10T04:45:42Z

← Older revision		Revision as of 21:45, 9 January 2014
Line 1:		Line 1:
	{{LSL_Event\|event_id		{{LSL_Event\|event_id
	\|event=http_request\|event_id=33\|event_delay		\|event=http_request\|event_id=33\|event_delay
	\|p1_type=key\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.		\|p1_type=key\|p1_subtype=handle\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.
	\|p2_type=string\|p2_name=method\|p2_desc=<code>{{String\|GET}}</code>, <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, <code>{{String\|DELETE}}</code>, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED		\|p2_type=string\|p2_name=method\|p2_desc=<code>{{String\|GET}}</code>, <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, <code>{{String\|DELETE}}</code>, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED
	\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.		\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.

Strife Onizuka: They are string values, for whatever reason LL didn't give us constants. The quotes make the usage more explicit and obvious.

2014-01-01T05:57:04Z

They are string values, for whatever reason LL didn't give us constants. The quotes make the usage more explicit and obvious.

← Older revision		Revision as of 22:57, 31 December 2013
Line 2:		Line 2:
	\|event=http_request\|event_id=33\|event_delay		\|event=http_request\|event_id=33\|event_delay
	\|p1_type=key\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.		\|p1_type=key\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.
	\|p2_type=string\|p2_name=method\|p2_desc=<code>GET</code>, <code>POST</code>, <code>PUT</code>, <code>DELETE</code>, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED		\|p2_type=string\|p2_name=method\|p2_desc=<code>{{String\|GET}}</code>, <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, <code>{{String\|DELETE}}</code>, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED
	\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.		\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.
	\|event_desc=Triggered when task receives an HTTP request.		\|event_desc=Triggered when task receives an HTTP request.
Line 11:		Line 11:
	* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.		* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.
	* There is a limit of 64 pending http_request		* There is a limit of 64 pending http_request
	* {{LSLP\|body}} is not sent with the request unless the method is set to <code>POST</code>, <code>PUT</code>, or [[URL_REQUEST_GRANTED]].		* {{LSLP\|body}} is not sent with the request unless the method is set to <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, or [[URL_REQUEST_GRANTED]].
	* Requests made at approx 0625 SLT may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code], with <code>ERROR: The requested URL could not be retrieved</code>, and <code>(111) Connection refused</code> in the body of the response. This has been confirmed as expected behaviour by [[User:Kelly Linden\|Kelly]], due to the nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.		* Requests made at approx 0625 SLT may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code], with <code>ERROR: The requested URL could not be retrieved</code>, and <code>(111) Connection refused</code> in the body of the response. This has been confirmed as expected behaviour by [[User:Kelly Linden\|Kelly]], due to the nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.
	\|examples=		\|examples=

Kireji Haiku: added wikipedia link

2013-12-31T15:48:33Z

added wikipedia link

← Older revision		Revision as of 08:48, 31 December 2013
Line 12:		Line 12:
	* There is a limit of 64 pending http_request		* There is a limit of 64 pending http_request
	* {{LSLP\|body}} is not sent with the request unless the method is set to <code>POST</code>, <code>PUT</code>, or [[URL_REQUEST_GRANTED]].		* {{LSLP\|body}} is not sent with the request unless the method is set to <code>POST</code>, <code>PUT</code>, or [[URL_REQUEST_GRANTED]].
	* Requests made at approx 0625 SLT may fail with a 503 status code, with <code>ERROR: The requested URL could not be retrieved</code>, and <code>(111) Connection refused</code> in the body of the response. This has been confirmed as expected behaviour by [[User:Kelly Linden\|Kelly]], due to the nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.		* Requests made at approx 0625 SLT may fail with a [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#5xx_Server_Error 503 status code], with <code>ERROR: The requested URL could not be retrieved</code>, and <code>(111) Connection refused</code> in the body of the response. This has been confirmed as expected behaviour by [[User:Kelly Linden\|Kelly]], due to the nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.
	\|examples=		\|examples=
	See [[LSL_http_server/examples]] for some examples from the feature design phase.		See [[LSL_http_server/examples]] for some examples from the feature design phase.

Kireji Haiku at 15:39, 31 December 2013

2013-12-31T15:39:58Z

Strife Onizuka at 22:16, 26 September 2013

2013-09-26T22:16:03Z

← Older revision		Revision as of 15:16, 26 September 2013
Line 137:		Line 137:
	** If the method is [[URL_REQUEST_GRANTED]] The body will contain the full url, minus the trailing forward slash.		** If the method is [[URL_REQUEST_GRANTED]] The body will contain the full url, minus the trailing forward slash.
	\|issues=		\|issues=
	{{Issue\|SVC-1086\|Design: LSL http_server\|type=fs\|status=ip}}		{{Issue/V1\|SVC-1086\|Design: LSL http_server\|type=fs\|status=ip}}
	\|cat1=HTTP		\|cat1=HTTP
	\|cat2=HTTP/Server		\|cat2=HTTP/Server

← Older revision		Revision as of 21:45, 9 January 2014
Line 1:		Line 1:
	{{LSL_Event\|event_id		{{LSL_Event\|event_id
	\|event=http_request\|event_id=33\|event_delay		\|event=http_request\|event_id=33\|event_delay
	\|p1_type=key\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.		\|p1_type=key\|p1_subtype=handle\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.
	\|p2_type=string\|p2_name=method\|p2_desc=<code>{{String\|GET}}</code>, <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, <code>{{String\|DELETE}}</code>, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED		\|p2_type=string\|p2_name=method\|p2_desc=<code>{{String\|GET}}</code>, <code>{{String\|POST}}</code>, <code>{{String\|PUT}}</code>, <code>{{String\|DELETE}}</code>, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED
	\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.		\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.

← Older revision		Revision as of 08:39, 31 December 2013
Line 2:		Line 2:
	\|event=http_request\|event_id=33\|event_delay		\|event=http_request\|event_id=33\|event_delay
	\|p1_type=key\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.		\|p1_type=key\|p1_name=request_id\|p1_desc=HTTP request id for response use, and function response identification.
	\|p2_type=string\|p2_name=method\|p2_desc=~~{{String\|~~GET}}, ~~{{String\|~~POST}}, ~~{{String\|~~PUT}}, ~~{{String\|~~DELETE}}, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED		\|p2_type=string\|p2_name=method\|p2_desc=<code>GET</code>, <code>POST</code>, <code>PUT</code>, <code>DELETE</code>, [[URL_REQUEST_GRANTED]], [[URL_REQUEST_DENIED]]\|p2_hover={{String\|GET}}, {{String\|POST}}, {{String\|PUT}}, {{String\|DELETE}}, URL_REQUEST_GRANTED, URL_REQUEST_DENIED
	\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.		\|p3_type=string\|p3_name=body\|p3_desc=Contents of the request.
	\|event_desc=Triggered when task receives an HTTP request.		\|event_desc=Triggered when task receives an HTTP request.
Line 8:		Line 8:
	\|spec=See [[LSL_http_server]] for full specification.		\|spec=See [[LSL_http_server]] for full specification.
	\|caveats=		\|caveats=
	* ~~'''~~body~~'''~~ is [[limit]]ed to 2048 bytes; anything longer will be truncated to 2048 bytes.		* {{LSLP\|body}} is [[limit]]ed to 2048 bytes; anything longer will be truncated to 2048 bytes.
	* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.		* headers (accessed with [[llGetHTTPHeader]]) are limited to 255 bytes.
	* There is a limit of 64 pending http_request		* There is a limit of 64 pending http_request
	* ~~'''~~body~~'''~~ is not sent with the request unless the method is set to POST, PUT, or URL_REQUEST_GRANTED		* {{LSLP\|body}} is not sent with the request unless the method is set to <code>POST</code>, <code>PUT</code>, or [[URL_REQUEST_GRANTED]].
	* Requests made at approx 0625 SLT may fail with a 503 status code, with "ERROR: The requested URL could not be retrieved", and "(111) Connection refused" in the body of the response. This has been confirmed as expected behaviour by Kelly, due to the nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.		* Requests made at approx 0625 SLT may fail with a 503 status code, with <code>ERROR: The requested URL could not be retrieved</code>, and <code>(111) Connection refused</code> in the body of the response. This has been confirmed as expected behaviour by [[User:Kelly Linden\|Kelly]], due to the nightly maint & log rotation. It does reliably impact object to object HTTP at that time, and quite probably may impact object to/from web around the same time. The interruption in service is fairly brief, and the precise timing may vary as LL adjust their nightly maint processes, or due to server load.
	\|examples=		\|examples=
	See [[LSL_http_server/examples]] for some examples from the feature design phase.		See [[LSL_http_server/examples]] for some examples from the feature design phase.