Difference between revisions of "Linden Lab Official:Registration API Request Form"

From Second Life Wiki
Jump to navigation Jump to search
Line 12: Line 12:
=== Using the API ===
=== Using the API ===


When you recieve your response from Linden Lab stating that you have been accepted into the Registration API program, follow these steps:
When you recieve your response from Linden Lab stating that you have been accepted into the Registration API program, follow the steps described in [[Registration_API#How_to_set_up_your_Reg_API|How to set up your Reg API]].
 
# Verify your capabilities using the [http://secondlife.com/developers/third_party_reg/#what_are_cap capabilities form].
# Make sure you have permission from the owner of the estate where your users will appear inworld.  You ''must'' have permission of the landowner (except for Linden Lab Orientation Islands).    If you have multiple registrations and need to send people to different locations, contact us to obtain additional assignments.
# Create your registration web page
# If using PHP, make sure the necessary libraries are installed and working (see http://uk.php.net/phpinfo )
# Test your registration application:
#* Register several new users.
#* If you aren't getting results you expect, check the [[Registration API Error Codes|error code]].
#* Create registrations to test the most common [[Registration API Error Codes|error codes]] and verify that you receive and properly handle them appropriately.


'''WHEN TESTING'''
'''WHEN TESTING'''
Line 27: Line 18:
If you are using the Reg API to sign up registrants on the main grid, users under 18 will not be allowed to register, since they are not permitted on the Main Grid.  Therefore, when testing, use a birth date that makes the registrant older than 18 years.
If you are using the Reg API to sign up registrants on the main grid, users under 18 will not be allowed to register, since they are not permitted on the Main Grid.  Therefore, when testing, use a birth date that makes the registrant older than 18 years.


Use an email address that does not currently exist in Second Life.  If a user has already registered with an email address, the Reg API will return error 95, email exists.
Use an email address that does not currently exist in Second Life.  If a user has already registered with an email address, the Reg API will return "error 95, email exists."
If you trap errors, you will see this error code, but if not, registration will simply fail.
If you trap errors, you will see this error code, but if not, registration will simply fail.


Revision as of 17:02, 9 November 2010

General procedure

Request form

  1. Fill out the form below. Required fields are marked with an asterisk (*).
  2. Click Submit. The information you entered will be displayed in the area underneath the form.
  3. Copy the text from the Copy and Paste box into your email and send to regapi@lists.lindenlab.com

Linden Lab will respond by email.

Reg API Request Form
The site where you will host the reg form (Example: http://secondlife.com/).
What are you trying to achieve by using the Reg API.

Please indicate why DirectSLURL is not sufficient.

Max 1200 characters
Please separate region names with commas.
Please enter only numerical values.
I understand the API setup requires PHP and Web Server expertise.
I have read and agree to the API Terms of Use & Second Life Terms of Service.


Copy and paste into email and send to regapi@lists.lindenlab.com. 





Using the API


When you recieve your response from Linden Lab stating that you have been accepted into the Registration API program, follow the steps described in How to set up your Reg API.

WHEN TESTING

If you are using the Reg API to sign up registrants on the main grid, users under 18 will not be allowed to register, since they are not permitted on the Main Grid.  Therefore, when testing, use a birth date that makes the registrant older than 18 years.

Use an email address that does not currently exist in Second Life.  If a user has already registered with an email address, the Reg API will return "error 95, email exists."
If you trap errors, you will see this error code, but if not, registration will simply fail.



Check your capabilities


Use the following form to display your current capabilities.
See Using capability URLs  for more information.








First Name



Last Name



Password



 








The form above simply POSTs your "first_name", "last_name" and "password" to https://cap.secondlife.com/get_reg_capabilities to get your capabilities.










Retrieved from "https://wiki.secondlife.com/w/index.php?title=Linden_Lab_Official:Registration_API_Request_Form&oldid=1102522"