Difference between revisions of "Viewer URI Name Space"

From Second Life Wiki
Jump to navigation Jump to search
(doh)
Line 14: Line 14:


Most secondlife:///app URLs only work from browser instances running inside Second Life because of a denial-of-service attack using secondlife:///app/teleport links to force repeated teleports.  SLURLs that work with external browsers include:
Most secondlife:///app URLs only work from browser instances running inside Second Life because of a denial-of-service attack using secondlife:///app/teleport links to force repeated teleports.  SLURLs that work with external browsers include:
* secondlife://<region name>
* <nowiki>secondlife://<region name></nowiki>
* secondlife:///app/login
* secondlife:///app/login




'''secondlife://'''
'''<nowiki>secondlife://</nowiki>'''
* <region_name> ''log in to this region or, if logged in, show information and offer teleport''
: '''<region_name>''' log in to this region or, if logged in, show information and offer teleport
** /<local_x> ''optional X position, defaults to 128''
:: '''/<local_x>''' optional X position, defaults to 128
*** /<local_y> ''optional Y position, defaults to 128''
::: '''/<local_y>''' optional Y position, defaults to 128
**** /<local_z> ''optional Z position, defaults to 0''
:::: '''/<local_z>''' optional Z position, defaults to 0
 
: '''/app'''
:: '''/agent'''
::: '''/<agent_id>'''
:::: '''/about''' open agent's profile, with 2nd Life tab selected
:::: '''/inspect''' display info dialog for agent (2.0)
:::: '''/im''' start an IM session with the agent (2.0)
:::: '''/offerteleport''' display teleport offer dialog (2.0)
:::: '''/pay''' display pay resident dialog (2.0)
:::: '''/requestfriend''' display friendship offer dialog (2.0)
:::: '''/mute''' add to block list (2.0)
:::: '''/unmute''' remove from block list (2.0)
:::: '''/completename''' get an avatar's display and user names e.g "Display Name (user.name)" (2.4)
:::: '''/displayname''' get an avatar's display name (2.4)
:::: '''/username''' get an avatar's username e.g "user.name" (2.4)
:: '''/appearance'''
::: '''/show''' display the sidebar appearance tab (2.0)
:: '''/balance'''
::: '''/request''' request a L$ balance update from the server (2.0)
:: '''/chat'''
::: '''/<channel>''' any channel number greater than or equal to 0
:::: '''/&lt;text>'''
:: '''/classified'''
::: '''/<classified_id>'''
:::: '''/about''' open floater describing classified
:: '''/event'''
::: '''/<event_id>'''
:::: '''/about''' open floater describing event
:: '''/group'''
::: '''/<group_id>'''
:::: '''/about''' open floater describing group
::: '''/create''' open the create group dialog (1.20)
::: '''/inspect''' display info dialog for group (2.0)
::: '''/list'''
:::: '''/show''' open the list of groups to which user belongs (1.20)
:: '''/help'''
::: '''/<help_query>''' optional help topic (2.0)
:: '''/inventory'''
::: '''/<inventory_id>'''
:::: '''/select''' inventory offer (2.0)
::: '''/show''' open the inventory sidebar tab (2.0)
:: '''/login''' log in on launch. External and internal browsers.
::: see below for query parameters, of course, values are URL escaped
:: '''/objectim'''
::: '''/<object_id>''' display an info dialog for the object sending this message (2.0)
:::: '''?name=<object_name>'''
:::: '''&owner=<owner_id>'''
:::: '''&groupowned=true''' (add if the object is deeded to a group)
:::: '''&slurl=<region>/<x>/<y>/<z>'''
:: '''/parcel'''
::: '''/<parcel_id>'''
:::: '''/about''' open floater describing place
:: '''<strike>/region'''
::: '''/<region_id>'''
:::: '''/about''' information from database about that region?  list of parcels?  covenant?</strike>
:: '''/search'''
::: '''/<category>''' "all", "people", "places", "events", "groups", "wiki", "destinations", "classifieds"
:::: '''/<search_term>''' open a search floater with matching results (2.0)
:: '''/teleport'''
::: '''/<region_name>''' teleport instantly to this region, no dialog
:::: '''/<local_x>''' optional X position, defaults to 128
::::: '''/<local_y>''' optional Y position, defaults to 128
:::::: '''/<local_z>''' optional Z position, defaults to 0
:: '''/worldmap''' open the map with this destination selected (2.0)
::: '''<region_name>'''
:::: '''/<local_x>''' optional X position, defaults to 128
::::: '''/<local_y>''' optional Y position, defaults to 128
:::::: '''/<local_z>''' optional Z position, defaults to 0


* /app
** /agent
*** /<agent_id>
**** /about ''open agent's profile, with 2nd Life tab selected''
**** /completename ''get an avatar's display and user names e.g "Display Name (user.name)" (2.4)''
**** /displayname ''get an avatar's display name (2.4)''
**** /inspect ''display info dialog for agent (2.0)''
**** /im ''start an IM session with the agent (2.0)''
**** /offerteleport ''display teleport offer dialog (2.0)''
**** /pay ''display pay resident dialog (2.0)''
**** /requestfriend ''display friendship offer dialog (2.0)''
**** /mute ''add to block list (2.0)''
**** /unmute ''remove from block list (2.0)''
**** /username ''get an avatar's username e.g "user.name" (2.4)''
** /appearance
*** /show ''display the sidebar appearance tab (2.0)''
** /balance
*** /request ''request a L$ balance update from the server (2.0)''
** /chat
*** /<channel> ''any channel number greater than or equal to 0''
**** /<text>
** /classified
*** /<classified_id>
**** /about ''open floater describing classified''
** /event
*** /<event_id>
**** /about ''open floater describing event''
** /group
*** /<group_id>
**** /about ''open floater describing group''
*** /create ''open the create group dialog (1.20)''
*** /inspect ''display info dialog for group (2.0)''
*** /list
**** /show ''open the list of groups to which user belongs (1.20)''
** /help
*** /<help_query> ''optional help topic (2.0)''
** /inventory
*** /<inventory_id>
**** /select ''inventory offer (2.0)''
*** /show ''open the inventory sidebar tab (2.0)''
** /login ''log in on launch. External and internal browsers.''
*** see below for query parameters, of course, values are URL escaped
** /objectim
*** /<object_id> ''display an info dialog for the object sending this message (2.0)''
**** ?name=<object_name>
**** &owner=<owner_id>
**** &groupowned=true ''(add if the object is deeded to a group)''
**** &slurl=<region>/<x>/<y>/<z>
** /parcel
*** /<parcel_id>
**** /about ''open floater describing place''
** <s>/region
*** /<region_id>
**** /about ''information from database about that region?  list of parcels?  covenant?''</s>
** /search
*** /<category> ''"all", "people", "places", "events", "groups", "wiki", "destinations", "classifieds"''
**** /<search_term> ''open a search floater with matching results (2.0)''
** /teleport
*** /<region_name> ''teleport instantly to this region, no dialog''
**** /<local_x> ''optional X position, defaults to 128''
***** /<local_y> ''optional Y position, defaults to 128''
****** /<local_z> ''optional Z position, defaults to 0''
** /worldmap ''open the map with this destination selected (2.0)''
*** <region_name>
**** /<local_x> ''optional X position, defaults to 128''
***** /<local_y> ''optional Y position, defaults to 128''
****** /<local_z> ''optional Z position, defaults to 0''
This could be extended to things like:
This could be extended to things like:
* /app/event/<event_id>/subscribe to register for notifications
: '''/app/event/<event_id>/subscribe''' to register for notifications
* /app/parcel/<parcel_id>/teleport to teleport to a specific location
: '''/app/parcel/<parcel_id>/teleport''' to teleport to a specific location


== Login Query Parameters ==
== Login Query Parameters ==

Revision as of 17:14, 24 March 2011

aka Viewer URL Namespace

aka SLAPP URLs

aka Application SLURL

The SL client supports links of the format secondlife://Region/123/45/67/, which have traditionally specified a region name and x/y/z location. This means "open Second Life and show Region on the world map".

The new URL scheme has 3 slashes, and allows direct control of the user interface and login. For example, secondlife:///app/login

Most secondlife:///app URLs only work from browser instances running inside Second Life because of a denial-of-service attack using secondlife:///app/teleport links to force repeated teleports. SLURLs that work with external browsers include:


secondlife://

<region_name> log in to this region or, if logged in, show information and offer teleport
/<local_x> optional X position, defaults to 128
/<local_y> optional Y position, defaults to 128
/<local_z> optional Z position, defaults to 0
/app
/agent
/<agent_id>
/about open agent's profile, with 2nd Life tab selected
/inspect display info dialog for agent (2.0)
/im start an IM session with the agent (2.0)
/offerteleport display teleport offer dialog (2.0)
/pay display pay resident dialog (2.0)
/requestfriend display friendship offer dialog (2.0)
/mute add to block list (2.0)
/unmute remove from block list (2.0)
/completename get an avatar's display and user names e.g "Display Name (user.name)" (2.4)
/displayname get an avatar's display name (2.4)
/username get an avatar's username e.g "user.name" (2.4)
/appearance
/show display the sidebar appearance tab (2.0)
/balance
/request request a L$ balance update from the server (2.0)
/chat
/<channel> any channel number greater than or equal to 0
/<text>
/classified
/<classified_id>
/about open floater describing classified
/event
/<event_id>
/about open floater describing event
/group
/<group_id>
/about open floater describing group
/create open the create group dialog (1.20)
/inspect display info dialog for group (2.0)
/list
/show open the list of groups to which user belongs (1.20)
/help
/<help_query> optional help topic (2.0)
/inventory
/<inventory_id>
/select inventory offer (2.0)
/show open the inventory sidebar tab (2.0)
/login log in on launch. External and internal browsers.
see below for query parameters, of course, values are URL escaped
/objectim
/<object_id> display an info dialog for the object sending this message (2.0)
?name=<object_name>
&owner=<owner_id>
&groupowned=true (add if the object is deeded to a group)
&slurl=<region>/<x>/<y>/<z>
/parcel
/<parcel_id>
/about open floater describing place
/region
/<region_id>
/about information from database about that region? list of parcels? covenant?
/search
/<category> "all", "people", "places", "events", "groups", "wiki", "destinations", "classifieds"
/<search_term> open a search floater with matching results (2.0)
/teleport
/<region_name> teleport instantly to this region, no dialog
/<local_x> optional X position, defaults to 128
/<local_y> optional Y position, defaults to 128
/<local_z> optional Z position, defaults to 0
/worldmap open the map with this destination selected (2.0)
<region_name>
/<local_x> optional X position, defaults to 128
/<local_y> optional Y position, defaults to 128
/<local_z> optional Z position, defaults to 0

This could be extended to things like:

/app/event/<event_id>/subscribe to register for notifications
/app/parcel/<parcel_id>/teleport to teleport to a specific location

Login Query Parameters

first the account first name
last the account last name
session the secure session id
location login location, format TBD, optional