Http response

From Second Life Wiki
Revision as of 17:42, 15 September 2007 by Hanover Dench (Talk | contribs)

Jump to: navigation, search

Description

Event: http_response( key request_id, integer status, list metadata, string body ){ ; }

Triggered when task receives a response to one of its llHTTPRequests

• key request_id Matches return from llHTTPRequest
• integer status HTTP code (like 404 or 200)
• list metadata List of HTTP_* constants and attributes
• string body
Constant Type Description
HTTP_BODY_TRUNCATED 0 integer Truncation point in bytes

Examples

key http_request_id;

default
{
    state_entry()
    {
        http_request_id = llHTTPRequest("url", [], "");
    }

    http_response(key request_id, integer status, list metadata, string body)
    {
        if (request_id == http_request_id)
        {
            llSetText(body, <0,0,1>, 1);
        }
    }
}

Notes

If for some reason while using llHTTPRequest/http_response you are unable to parse a known good RSS feed or some other form of web contents, you will need to work around it outside of SecondLife. This is unlikely to change in the near future since checking the headers requires more overhead at the simulator level.

Status 499 is never returned by a website in response to an llHTTPRequest call. This status indicates that the request timed out and the sim closed the connection before any response was received.

Some useful HTTP headers sent are:

  • HTTP_X_SECONDLIFE_LOCAL_POSITION
  • HTTP_X_SECONDLIFE_LOCAL_ROTATION
  • HTTP_X_SECONDLIFE_LOCAL_VELOCITY
  • HTTP_X_SECONDLIFE_OBJECT_KEY
  • HTTP_X_SECONDLIFE_OBJECT_NAME
  • HTTP_X_SECONDLIFE_OWNER_KEY
  • HTTP_X_SECONDLIFE_OWNER_NAME
  • HTTP_X_SECONDLIFE_REGION
  • HTTP_X_SECONDLIFE_SHARD

See Also

Functions

•  llHTTPRequest

Deep Notes

Signature

event void http_response( key request_id, integer status, list metadata, string body );