LSL Protocol/Restrained Love Open Relay Group/gridurl

From Second Life Wiki
Jump to navigation Jump to search

gridurl

STATUS: proposal

version: 000

The idea of this ORG x-tension comes from the site http://gridurl.appspot.com/about built by Latif Khalifa.

RECOMMENDED WITH: key,email

Description of !x-gridurl

The controller tells the relay to open a Web site and to send its URL in a server outside SecondLife. The syntax is

!x-gridurl/STRING/STRING/STRING/STRING

For example:

!x-gridurl/server.subdomain.domain/reg/relayurl/gorelay

where http://server.subdomain.domain is the URL where to send the URL of the server with a GET on the address

http://server.subdomain.domain/reg?relayurl=<current_url>

The acknowledgment of receipt of the relay is

!x-gridurl/server.subdomain.domain/reg/relayurl/gorelay,ok

if the command is accepted (URL created and registred in the site server.subdomain.domain); otherwise the acknowledgment is

!x-gridurl/server.subdomain.domain/reg/relayurl/gorelay,ko

The relay will take care of resending the URL after a new rezzing, or if the wearer changes of region. The controller will be able to get back the uuid key of the relay by the command <lsl>

llHTTPRequest("http://server.subdomain.domain/gorelay/<uuid_of_the wearer_of_the_relay>",["POST"],"ping")

</lsl> The UUID key will be received in an event http_response().

Interest of this command

This command is intended to be used with key. Its interest is that the controller can take over a session even if the relay is not in the same region. The session must be an email session using the x-tension email. As soon as the UUID key of the relay is received by the controller, a !x-takeover sends by email to the relay restores the session.