Difference between revisions of "LlRequestSecureURL"

From Second Life Wiki
Jump to navigation Jump to search
m (changed example script and added tip)
m (added port info)
Line 3: Line 3:
|func=llRequestSecureURL|return_type=key
|func=llRequestSecureURL|return_type=key
|func_footnote
|func_footnote
|func_desc=Requests one HTTPS:// (SSL) url for use by this object. The [[http_request]] event is tiggered with results.
|func_desc=Requests one HTTPS:// (SSL) url for use by this [[object]]. The [[http_request]] [[event]] is tiggered with result of the request. HTTPS-in uses port 12043.
|return_text=that is the handle used for identifying the request in the [[http_request]] event.
|return_text=that is the handle used for identifying the result of the request in the [[http_request]] [[event]].
|spec
|spec
|caveats=*When a region is (re)started all [[http_request|HTTP server]] URLs are automatically released and invalidated.
|caveats=*HTTPS-in uses port 12043.
*When a region is (re)started all [[http_request|HTTP server]] URLs are automatically released and invalidated.
**Use [[CHANGED_REGION_START]] to detect this so new URL can be requested.
**Use [[CHANGED_REGION_START]] to detect this so new URL can be requested.
|constants
|constants

Revision as of 12:29, 9 January 2014

Summary

Function: key llRequestSecureURL( );
0.0 Forced Delay
10.0 Energy

Requests one HTTPS:// (SSL) url for use by this object. The http_request event is tiggered with result of the request. HTTPS-in uses port 12043.
Returns a key that is the handle used for identifying the result of the request in the http_request event.

Caveats

  • HTTPS-in uses port 12043.
  • When a region is (re)started all HTTP server URLs are automatically released and invalidated.

Examples

KBcaution.png Important: Never ever forget to release a URL again which you have requested! URLs are region resources just like prims. If you take them all you can get into big trouble with the sim owner and/or estate managers.

Requesting a secure URL. <lsl> string secureUrl; key urlRequestId; key selfCheckRequestId;

request_secure_url() {

   llReleaseURL(secureUrl);
   secureUrl = "";

   urlRequestId = llRequestSecureURL();

}

throw_exception(string inputString) {

   key owner = llGetOwner();
   llInstantMessage(owner, inputString);

   // yeah, bad way to handle exceptions by restarting.
   // However this is just a demo script...

   llResetScript();

}

default {

   on_rez(integer start_param)
   {
       llResetScript();
   }

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

See Also

Functions

•  llRequestURL
•  llGetFreeURLs
•  llReleaseURL
•  llHTTPResponse
•  llGetHTTPHeader

Articles

•  LSL http server

Deep Notes

History

Signature

function key llRequestSecureURL();