Difference between revisions of "LSL Protocol/Restrained Love Open Relay Group/gridurl"

From Second Life Wiki
Jump to navigation Jump to search
Line 12: Line 12:


The controller tells the relay to open a Web site and to send its URL in a server outside SecondLife. The syntax is  
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/server.subdomain.domain/reg/avatar/url
!x-gridurl/STRING/STRING/STRING
For example:
  !x-gridurl/server.subdomain.domain/reg/relayurl
where (http://)server.subdomain.domain is the URL where to send the URL of the server with the command   
where (http://)server.subdomain.domain is the URL where to send the URL of the server with the command   
  (http:)//server.subdomain.domain/reg?avatar=<uuid_of_the wearer_of_the_relay>&url=<current_url>
  (http:)//server.subdomain.domain/reg?relayurl=<current_url>


The acknowledgment of receipt of the relay is  
The acknowledgment of receipt of the relay is  
  !x-gridurl/server.subdomain.domain/reg/avatar/url,ok
  !x-gridurl/server.subdomain.domain/reg/relayurl,ok
if the command is accepted (URL created ''and'' registred in the site server.subdomain.domain); otherwise the acknowledgment is  
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/avatar/url,ko
  !x-gridurl/server.subdomain.domain/reg/relayurl,ko


The relay will take care of resending the URL after a new rezzing, or if the wearer changes of region.
The relay will take care of resending the URL after a new rezzing, or if the wearer changes of region.

Revision as of 04:18, 22 November 2011

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

For example:

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

where (http://)server.subdomain.domain is the URL where to send the URL of the server with the command

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

The acknowledgment of receipt of the relay is

!x-gridurl/server.subdomain.domain/reg/relayurl,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,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.