OsRequestURL
From OpenSimulator
key osRequestURL(list options)
| |
Requests one HTTP:// url (opensim version 0.9 or over)
Option supported : "allowXss" - Add 'Access-Control-Allow-Origin: *' to response header | |
Threat Level | Moderate |
Permissions | No permissions specified |
Extra Delay | 0 seconds |
Example(s) | |
// //osRequestURL example // RequestReceived (key id, string query) { llHTTPResponse (id,200,query+" OK"); query = llUnescapeURL(query); llSay (0, query); } default { state_entry() { osRequestURL ([ "allowXss" ]); } http_request(key id, string method, string body) { if (method == URL_REQUEST_GRANTED) llOwnerSay ("URL_REQUEST_GRANTED" +"\n" +body); if (method == URL_REQUEST_DENIED) llOwnerSay ("URL_REQUEST_DENIED"); if (method == "GET") RequestReceived (id, llGetHTTPHeader(id,"x-query-string")); if (method == "POST") RequestReceived (id, body); } } /* Respond to incoming HTTP requests Description: This script demonstrates handling HTTP requests in OpenSimulator. It provides a simple web server that responds to GET and POST requests and logs the received data. Usage: Attach this script to an in-world object in OpenSimulator. When the object is rezzed and initialized, it will request permissions for handling HTTP requests using osRequestURL. The script listens for incoming HTTP requests, and when a request is received, it logs whether the request was granted or denied, and it processes GET and POST requests by calling the RequestReceived function. The RequestReceived function sends a response to the client with a status code of 200 (OK) and logs the received data in local chat. It also decodes URL-encoded data using llUnescapeURL. You can monitor the HTTP request handling in the local chat of the object, as specified in the llOwnerSay calls. */ RequestReceived(key id, string query) { llHTTPResponse(id, 200, query + " OK"); // Send a response query = llUnescapeURL(query); // Decode URL-encoded data llSay(0, query); // Log the received data to local chat } default { state_entry() { osRequestURL(["allowXss"]); // Request permissions for handling HTTP requests } // Handle incoming HTTP requests http_request(key id, string method, string body) { if (method == URL_REQUEST_GRANTED) llOwnerSay("URL_REQUEST_GRANTED\n" + body); // Log URL_REQUEST_GRANTED if (method == URL_REQUEST_DENIED) llOwnerSay("URL_REQUEST_DENIED"); // Log URL_REQUEST_DENIED if (method == "GET") RequestReceived(id, llGetHTTPHeader(id, "x-query-string")); // Process GET requests if (method == "POST") RequestReceived(id, body); // Process POST requests } } | |
Notes | |
This function was added in 0.9.0-post-fixes |