LlGetHTTPHeader

2009-09-28T06:31:03Z

Ninamori Writer: Changed llSay to llOwnerSay so the IP doesnt go to public chat

{{LSL_Function
|func_id=349|func_sleep=0.0|func_energy=10.0|mode
|func=llGetHTTPHeader|return_type=string
|p1_type=key|p1_name=request_id|p1_desc=A valid HTTP request key.
|p2_type=string|p2_name=header|p2_desc=Header value name.
|func_footnote
|func_desc
|return_text=that is the value for '''header''' for '''request_id'''.
|spec=
===Generated Headers===
These headers are automatically generated by the simulator, they were not actually sent by the requesting client. They supply information about the request to make parsing easier.

Sample URL: [https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322/foo/bar?arg=gra {{HoverTextStyle|style=color:green;|<nowiki>https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322</nowiki>|2={{String|x-script-url}} = {{String|https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322}}}}{{HoverTextStyle|style=color:blue;|/foo/bar|2={{String|x-path-info}} = {{String|/foo/bar}}}}?{{HoverTextStyle|style=color:red;|1=arg=gra|2={{String|x-query-string}} = {{String|1=arg=gra}}}}]

{{{!}} class="lltable" border="1"
! header
! description
! example
{{!}}-
{{!}} style="white-space: nowrap;" {{!}} "x-script-url"
{{!}} The base url, as originally received from [[llRequestURL]]/[[llRequestSecureURL]]
{{!}} <nowiki>https://sim3015.aditi.lindenlab.com:12043/cap/a7717681-2c04-e4ac-35e3-1f01c9861322</nowiki>
{{!}}-
{{!}} style="white-space: nowrap;" {{!}} "x-path-info"
{{!}} Any trailing path information from the requested url
{{!}} /foo/bar
{{!}}-
{{!}} style="white-space: nowrap;" {{!}} "x-query-string"
{{!}} Any query arguments, the text past the first "?" in the url
{{!}} arg=gra
{{!}}-
{{!}} style="white-space: nowrap;" {{!}} "x-remote-ip"
{{!}} IP address of the host that made the request
{{!}}
{{!}}}

===Common Headers===

{{{!}} class="lltable" border="1"
! header
! description
! example
{{!}}-
{{!}} style="white-space: nowrap;" {{!}} "user-agent"
{{!}} The user-agent header as reported by the requester
{{!}}
{{!}}}

===[[llHTTPRequest]] Headers===
{{LSL_Constants/HTTP_Headers|lower-case=*}}
|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.
* The header names listed above are incorrect - they should all be fully lower case (i.e. x-secondlife-shard, x-secondlife-object-name, x-secondlife-object-key, x-secondlife-region, etc.
|constants
|examples=
<lsl>
key url_request;

default
{
state_entry()
{
url_request = llRequestURL();
}
http_request(key id, string method, string body)
{
if (url_request == id)
{
url_request = "";
if (method == URL_REQUEST_GRANTED)
{
llOwnerSay("URL: " + body);
if(llGetAgentSize(llGetOwner()))
llLoadURL(llGetOwner(), "", body);
}
else if (method == URL_REQUEST_DENIED)
{
llOwnerSay( "Something went wrong, no url. " + body);
}
}
else
{
list headers = [ "x-script-url", "x-path-info", "x-query-string", "x-remote-ip", "user-agent" ];
integer pos = ~llGetListLength(headers);
while( ++pos )
{
string header = llList2String(headers, pos);
llOwnerSay(header + ": " + llGetHTTPHeader(id, header));
}
llOwnerSay( "body: " + body);
llHTTPResponse(id, 200, body);
}
}
}
</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llGetFreeURLs]]}}
{{LSL DefineRow||[[llRequestURL]]}}
{{LSL DefineRow||[[llRequestSecureURL]]}}
{{LSL DefineRow||[[llReleaseURL]]}}
{{LSL DefineRow||[[llHTTPResponse]]}}
|also_tests
|also_events=
{{LSL DefineRow||[[http_request]]}}
|also_articles=
{{LSL DefineRow||[[LSL http server]]}}
{{LSL DefineRow||{{Wikipedia|List_of_HTTP_headers|Wikipedia:List of HTTP headers}}}}
|notes
|deepnotes=
|history=
*{{SVN|1836|rev=112899 |trunk=*|anchor=file22|ver=|ser=}}
|cat1=HTTP
|cat2=HTTP/Server
|cat3
|cat4
}}

Second Life Wiki - User contributions [en]

LlGetHTTPHeader