Difference between revisions of "LlGetHTTPHeader"

From Second Life Wiki
Jump to navigation Jump to search
m (preview marked)
(Add header info to Spec - format needs work)
Line 7: Line 7:
|func_desc
|func_desc
|return_text=that is the value for '''header''' for '''request_id'''.
|return_text=that is the value for '''header''' for '''request_id'''.
|spec
|spec=
;Supported Headers
* "x-script-url": The base url, as originally recieved from llRequestPublicURL
* "x-path-info": Any trailing path information from the requested url
* "x-query-string": Any query arguments, the text past a ? in the url
* "x-remote-ip": IP address of the host that made the request
* "user-agent": The user-agent header as reported by the requester
<!--
requested url: ''https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322/foo/bar?arg=gra''
x-script-url: ''https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322''
x-path-info: ''/foo/bar''
x-query-string: ''arg=gra''
-->
|caveats=* LSL is not a CGI environment
|caveats=* LSL is not a CGI environment
** "Content-Type" is an example of a normal header name, in a CGI environment the name would be "HTTP_CONTENT_TYPE".
** "Content-Type" is an example of a normal header name, in a CGI environment the name would be "HTTP_CONTENT_TYPE".
* This header information is valid for 30 seconds, or until ''llHTTPResponse()'' is called.
|constants
|constants
|examples=
|examples=

Revision as of 11:20, 12 July 2009

  Note! Preview Documentation

This function only exists on the preview grid

Summary

Function: string llGetHTTPHeader( key request_id, string header );
0.0 Forced Delay
10.0 Energy

Returns a string that is the value for header for request_id.

• key request_id A valid HTTP request key.
• string header Header value name.

Specification

Supported Headers
  • "x-script-url": The base url, as originally recieved from llRequestPublicURL
  • "x-path-info": Any trailing path information from the requested url
  • "x-query-string": Any query arguments, the text past a ? in the url
  • "x-remote-ip": IP address of the host that made the request
  • "user-agent": The user-agent header as reported by the requester

Caveats

  • LSL is not a CGI environment
    • "Content-Type" is an example of a normal header name, in a CGI environment the name would be "HTTP_CONTENT_TYPE".
  • This header information is valid for 30 seconds, or until llHTTPResponse() is called.

Examples

See Also

Events

•  http_request

Functions

•  llGetFreeURLs
•  llRequestURL
•  llRequestSecureURL
•  llReleaseURL
•  llHTTPResponse

Articles

•  LSL http server
•  "Wikipedia logo"Wikipedia:List of HTTP headers

Deep Notes

History

Signature

function string llGetHTTPHeader( key request_id, string header );