RegAPIOverview

From Second Life Wiki
Revision as of 16:12, 12 April 2007 by Glenn Linden (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This page is the same content as that on the Registration API page of SecondLife.com.

Capabilities

The Registration API (RegAPI) provides you with two capabilities:

  • It allows you to customize the registration process.
  • It delivers registrants to an area of your choice in SL

To submit a request to participate in the Registration API program, fill out the registration API request form. We will contact you by email once your application has been reviewed.

TERMS OF USE

Please note that all participants in our API programs must abide by our API Terms Of Use.

Description

The Registration API allows you to programatically register users into Second Life from your web site. In addition, it allows you to have control over certain options, such as a a registrant's start location and estate limits.

Features

  • The API is a simple REST style web service
  • The documents passed into and from the service urls are encoded in our XML format called LLSD. We have libraries to parse and encode LLSD for the following languages: Perl, PHP, Python, and Ruby. This information goes from XML to native objects and vice-versa.
  • The API enables you to register people for Second Life on your website in the way that you desire.
  • The Registration API DOES NOT:
    • allow you to skin the client login†
    • add people to groups†
    • provide registrants with inventory†
    • control avatar choices or clothing†
    • restrict where you can place people upon log-in (please make sure that the owner of the landing location agrees to have your registrants arrive there if you don't own that land)
    • provide load balancing††

†These are future features that we will announce when they become available.

††If you expect a large number of registrants you'll need to provide a way to manage distribution. However, it is possible to code your front end to place each new registrant in a different area. Those areas could be determined by an object on regions sending real-time avatar count data out of Second Life. The registration portal could be coded to query that data and then round robin people who are registering to locations with the least amount of people. This only applies to the initial entry into Second Life, so can be used to manage orientation, for example. Since the Registration API does not apply to any subsequent entry into Second Life, it can not be used to manage event attendance, for example.