Difference between revisions of "LlHTTPResponse"

From Second Life Wiki
Jump to: navigation, search
m (added reference to http_response event to also section)
m
Line 7: Line 7:
 
|p3_type=string|p3_name=body|p3_desc=Contents of the response.
 
|p3_type=string|p3_name=body|p3_desc=Contents of the response.
 
|func_footnote=The response need not be made inside the [[http_request]] event but if it does not happen in a timely fashion the request will time out (within 25 seconds).
 
|func_footnote=The response need not be made inside the [[http_request]] event but if it does not happen in a timely fashion the request will time out (within 25 seconds).
|func_desc=Responds to '''request_id''' with '''status''' and '''body'''.
+
|func_desc=Responds to {{LSLP|request_id}} with {{LSLP|status}} and {{LSLP|body}}.
 
|return_text
 
|return_text
 
|spec
 
|spec
|caveats=* This call must be made by the script containing the [[http_request]] event where the '''request_id''' was received.
+
|caveats=* This call must be made by the script containing the [[http_request]] event where the {{LSLP|request_id}} was received.
 
* There is no limit, other than script size, to the amount of data that can be sent by this function.
 
* There is no limit, other than script size, to the amount of data that can be sent by this function.
 
** [[llHTTPRequest]] can truncate the response length in ''receiving'' scripts. Be aware when using them together for prim-to-prim communications.
 
** [[llHTTPRequest]] can truncate the response length in ''receiving'' scripts. Be aware when using them together for prim-to-prim communications.
* Returns 'content-type: text/plain' by default. Use [[llSetContentType]] to optionally return 'text/html' if being viewed by the object owner within a Second Life client.
+
* The response by default has 'content-type: text/plain'. Use [[llSetContentType]] to optionally return a different type, like 'text/html'.
 
|constants
 
|constants
 
|examples=
 
|examples=

Revision as of 00:07, 2 January 2014

Summary

Function: llHTTPResponse( key request_id, integer status, string body );

Responds to request_id with status and body.

• key request_id A valid HTTP request key.
• integer status HTTP Status (200, 400, 404, etc)
• string body Contents of the response.

The response need not be made inside the http_request event but if it does not happen in a timely fashion the request will time out (within 25 seconds).

Caveats

  • This call must be made by the script containing the http_request event where the request_id was received.
  • There is no limit, other than script size, to the amount of data that can be sent by this function.
    • llHTTPRequest can truncate the response length in receiving scripts. Be aware when using them together for prim-to-prim communications.
  • The response by default has 'content-type: text/plain'. Use llSetContentType to optionally return a different type, like 'text/html'.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> string url;

default {

   changed(integer change)
   {
if (change & (CHANGED_REGION_START

Deep Notes

History

All Issues

~ Search JIRA for related Issues
   llHTTPImageResponse() - function for sending image data as a response to an HTTP request

Signature

function void llHTTPResponse( key request_id, integer status, string body );