Difference between revisions of "Linden Lab Official:Registration API Error Codes"

From Second Life Wiki
Jump to navigation Jump to search
(RegAPI 2.1 update)
Line 5: Line 5:
<br clear="all" />
<br clear="all" />
The Reg API has a detailed set of error codes, to help you handle user and software errors.  To see a list of the error codes, use the get_error_codes operation.  See the [[Registration_API_Reference#get_error_codes | API Reference]] for more information.
The Reg API has a detailed set of error codes, to help you handle user and software errors.  To see a list of the error codes, use the get_error_codes operation.  See the [[Registration_API_Reference#get_error_codes | API Reference]] for more information.
== Uncaught errors ==
If the Reg API system cannot handle an error, you'll get back a plain text message containing the error ticket of what caused the exception, for example:
An fatal error has occurred (error ticket #12345).
Please visit the support section at http://secondlife.com/support/ for further assistance.
Note the error ticket code and description of the problem.
Error Description: undefined method `permission' for #<User:0x00000000>.
If you get an uncaught error, note the cause, the error ticket number, and email Linden Lab with the information.


== Error codes ==
== Error codes ==
Line 25: Line 15:
! Message
! Message
! Description
! Description
|-
|-
| 20
| 10
| missing required field
| missing required field
| You are missing one of the required fields
| You are missing one of the required fields


|-
|-
|30
| 11
|unallowed extra field
| invalid post
|You are including a field that is not being used
| Could not parse post body submitted.
 
|-
| 12
| unallowed extra field
| You are including a field that is not being used
 
|-
| 50
| invalid last name id
| Last name id does not exist
 
|-
| 51
| invalid username
| Username is not valid (must be alphanumeric between 2-31 characters)
 
|-
| 52
| invalid user
| The user requested does not exist
 
|-
| 53
| invalid start_local_x
| start_local_x must be between 0-256


|-
|-
|40
| 54
|banned username
| invalid start_local_y
|Username is on the banned list
| start_local_y must be between 0-256


|-
|-
|50
| 55
|no perm last name id
| invalid start_local_z
|You are not allowed to register a user with this last name id
| start_local_z must be between 0-4000


|-
|-
|60
| 56
|invalid last name id
| invalid start_look_at_x
|Last name id does not exist
| start_look_at_x must be between -1 and 1


|-
|-
|70
| 57
|invalid username
| invalid start_look_at_y
|Username is not valid (must be alphanumeric between 2-31 characters)
| start_look_at_y must be between -1 and 1


|-
|-
|80
| 58
|invalid password
| invalid start_look_at_z
|Password is not valid (must be between 6-16 characters)
| start_look_at_z must be between -1 and 1


|-
|-
|90
| 59
|invalid email
| invalid agent_id
|Not a valid email
| agent_id does not exist


|-
|-
|95
| 60
|email exists
| invalid group id
|Another user is currently using this email
| Failed to find group requested


|-
|-
|100
| 61
|invalid dob
| invalid experience_id
|Not a valid date
| The requested experience does not exist


|-
|-
|110
| 62
|malformed dob
| invalid avatar_id
|Date string is malformed
| The requested avatar does not exist


|-
|-
|120
| 63
|user exists
| invalid start_region_name
|User with specified username and last_name_id already exists
| Start location region does not exist


|-
|-
|130
| 64
|invalid start_region_name
| invalid limited_to_estate
|Start location region does not exist
| Limited estate cannot be set to an estate does not exist


|-
|-
|140
| 65
|no perm start_region_name
| invalid url length
|You do not have permission to place a user in this region, because you do not own the estate that it is in
| Success and Error URLs must be 500 or fewer characters in length.


|-
|-
|150
| 70
|invalid limited_to_estate
| banned username
|Limited estate cannot be set to an estate does not exist
| Username is on the banned list


|-
|-
|160
| 71
|no perm limited_to_estate
| user exists
|Limited estate cannot be set to an estate you do not own, besides mainland (estate_id = 1)
| User with specified username and last_name_id already exists


|-
|-
|170
| 72
|invalid region location options
| missing orientation island or start location
|the region location options (e.g. local_x, local_y) are invalid
| You cannot set up a user to be on an estate without either 1) the estate having an orientation island or 2) setting the user's start location to a region that is in the estate


|-
|-
|180
| 100
|missing orientation island or start location
| no perm user
|You cannot set up a user to be on an estate without either 1) the estate having an orientation island or 2) setting the user's start location to a region that is in the estate
| only the original registrar of this user can set values for it


|-
|-
|190
| 101
|cannot register teen to non-teen grid
| no perm last name id
|You cannot register a teen to a non-teen grid
| You are not allowed to register a user with this last name id


|-
|-
|191
| 102
|cannot register adult to non-adult grid
| no perm experience
|You cannot register an adult to a non-adult grid
| only administrators of an experience can add users to it


|-
|-
|195
| 103
|cannot register underage user
| no perm upgrade
|You cannot register a user into secondlife under 13
| only original registrar of user can upgrade


|-
|-
|196
| 104
|underage user must be limited to estate
| no perm start_region_name
|Underage users (< 16 years old) must be limited to a private, G-rated estate
| You do not have permission to place a user in this region, because you do not own the estate that it is in


|-
|-
|210
| 105
|invalid start_local_x
| no perm limited_to_estate
|start_local_x must be between 0-256
| Limited estate cannot be set to an estate you do not own, besides mainland (estate_id = 1)


|-
|-
|220
| 106
|invalid start_local_y
| invalid group perm
|start_local_y must be between 0-256
| not allowed to add members to this group


|-
|-
|230
| 107
|invalid start_local_z
| timeout perm user
|start_local_z must be between 0-256
| the registrar can no longer set values for this user


|-
|-
|240
| 108
|invalid start_look_at_x
| already logged
|start_look_at_x must be between -1 and 1
| this user has already logged in and cannot have values modified by their registrar


|-
|-
|250
| 109
|invalid start_look_at_y
| already activated
|start_look_at_y must be between -1 and 1
| this user has already activated their account


|-
|-
|260
| 130
|invalid start_look_at_z
| group set failed
|start_look_at_z must be between -1 and 1
| failed to set active group


|-
|-
|270
| 131
|invalid agent_id
| group set exists
|agent_id does not exist
| the group operation attempted has already been completed


|-
|-
|280
| 300
|invalid account_type
| wrong type username
|account_type can only be set as 'Monthly', 'Quarterly', or 'Annual'
| username must be type string


|-
|-
|285
| 301
|no perm upgrade
| wrong type last_name_id
|only original registrar of user can upgrade
| last_name_id must be type integer


|-
|-
|290
| 303
|cannot upgrade non-base user
| wrong type limited_to_estate
|users of 'Base' status can only be upgraded
| limited_to_estate id must be type integer


|-
|-
|295
| 304
|group set failed
| wrong type start_region_name
|failed to set active group
| start_region_name must be type string


|-
|-
|296
| 305
|invalid group perm
| wrong type start_local_x
|not allowed to add members to this group
| start_local_x must be type real


|-
|-
|297
| 306
|invalid group id
| wrong type start_local_y
|failed to find group
| start_local_y must be type real


|-
|-
|300
| 307
|wrong type username
| wrong type start_local_z
|username must be type string
| start_local_z must be type real


|-
|-
|310
| 308
|wrong type last_name_id
| wrong type start_look_at_x
|last_name_id must be type integer, or a string that represents an integer
| start_look_at_x must be type real


|-
|-
|320
| 309
|wrong type dob
| wrong type start_look_at_y
|dob must be type string
| start_look_at_y must be type real


|-
|-
|330
| 311
|wrong type email
| wrong type start_look_at_z
|email must be type string
| start_look_at_z must be type real


|-
|-
|340
| 312
|wrong type password
| wrong type agent_id
|password must be type string
| user id must be type UUID


|-
|-
|350
| 313
|wrong type limited_to_estate
| wrong type avatar_id
|limited_to_estate id must be type integer, or a string that represents an integer
| avatar id must be type UUID


|-
|-
|360
| 314
|wrong type start_region_name
| wrong type experience_id
|start_region_name must be type string
| experience id must be type UUID


|-
|-
|370
| 315
|wrong type start_local_x
| wrong type success_url
|start_local_x must be type float, or a string that represents a float
| success url must be type URI


|-
|-
|380
| 316
|wrong type start_local_y
| wrong type error_url
|start_local_y must be type float, or a string that represents a float
| success url must be type URI


|-
|-
|390
| 317
|wrong type start_local_z
| wrong type first
|start_local_z must be type float, or a string that represents a float
| 'first' must be type string


|-
|-
|400
| 318
|wrong type start_look_at_x
| wrong type last
|start_look_at_x must be type float, or a string that represents a float
| 'last' must be type string


|-
|-
|410
| 319
|wrong type start_look_at_y
| wrong type group_name
|start_look_at_y must be type float, or a string that represents a float
| group name must be type string


|-
|-
|420
| 500
|wrong type start_look_at_z
| over registration limit
|start_look_at_z must be type float, or a string that represents a float
| you have registered over your maximum amount of users you can register in a 24 hour period.


|-
|-
|500
| 600
|over registration limit
| invalid credentials
|you have registered over your maximum amount of users you can register in a 24 hour period.
| Invalid credentials.


|-
|-
|1500
| 1500
|malformed xml
| unhandled exception
|Your xml is malformed
| There was an unhandled exception attempting to process this request. Please contact support with the endpoint you were attempting to access.


|}
|}

Revision as of 09:57, 26 October 2016

NOTE: This is an official Second Life API provided and documented by Linden Lab. Its use is subject to the API Terms of Use.


The Reg API has a detailed set of error codes, to help you handle user and software errors. To see a list of the error codes, use the get_error_codes operation. See the API Reference for more information.

Error codes

The Reg API provides the error codes shown in the following table.


Code Message Description
10 missing required field You are missing one of the required fields
11 invalid post Could not parse post body submitted.
12 unallowed extra field You are including a field that is not being used
50 invalid last name id Last name id does not exist
51 invalid username Username is not valid (must be alphanumeric between 2-31 characters)
52 invalid user The user requested does not exist
53 invalid start_local_x start_local_x must be between 0-256
54 invalid start_local_y start_local_y must be between 0-256
55 invalid start_local_z start_local_z must be between 0-4000
56 invalid start_look_at_x start_look_at_x must be between -1 and 1
57 invalid start_look_at_y start_look_at_y must be between -1 and 1
58 invalid start_look_at_z start_look_at_z must be between -1 and 1
59 invalid agent_id agent_id does not exist
60 invalid group id Failed to find group requested
61 invalid experience_id The requested experience does not exist
62 invalid avatar_id The requested avatar does not exist
63 invalid start_region_name Start location region does not exist
64 invalid limited_to_estate Limited estate cannot be set to an estate does not exist
65 invalid url length Success and Error URLs must be 500 or fewer characters in length.
70 banned username Username is on the banned list
71 user exists User with specified username and last_name_id already exists
72 missing orientation island or start location You cannot set up a user to be on an estate without either 1) the estate having an orientation island or 2) setting the user's start location to a region that is in the estate
100 no perm user only the original registrar of this user can set values for it
101 no perm last name id You are not allowed to register a user with this last name id
102 no perm experience only administrators of an experience can add users to it
103 no perm upgrade only original registrar of user can upgrade
104 no perm start_region_name You do not have permission to place a user in this region, because you do not own the estate that it is in
105 no perm limited_to_estate Limited estate cannot be set to an estate you do not own, besides mainland (estate_id = 1)
106 invalid group perm not allowed to add members to this group
107 timeout perm user the registrar can no longer set values for this user
108 already logged this user has already logged in and cannot have values modified by their registrar
109 already activated this user has already activated their account
130 group set failed failed to set active group
131 group set exists the group operation attempted has already been completed
300 wrong type username username must be type string
301 wrong type last_name_id last_name_id must be type integer
303 wrong type limited_to_estate limited_to_estate id must be type integer
304 wrong type start_region_name start_region_name must be type string
305 wrong type start_local_x start_local_x must be type real
306 wrong type start_local_y start_local_y must be type real
307 wrong type start_local_z start_local_z must be type real
308 wrong type start_look_at_x start_look_at_x must be type real
309 wrong type start_look_at_y start_look_at_y must be type real
311 wrong type start_look_at_z start_look_at_z must be type real
312 wrong type agent_id user id must be type UUID
313 wrong type avatar_id avatar id must be type UUID
314 wrong type experience_id experience id must be type UUID
315 wrong type success_url success url must be type URI
316 wrong type error_url success url must be type URI
317 wrong type first 'first' must be type string
318 wrong type last 'last' must be type string
319 wrong type group_name group name must be type string
500 over registration limit you have registered over your maximum amount of users you can register in a 24 hour period.
600 invalid credentials Invalid credentials.
1500 unhandled exception There was an unhandled exception attempting to process this request. Please contact support with the endpoint you were attempting to access.
Retrieved from "https://wiki.secondlife.com/w/index.php?title=Linden_Lab_Official:Registration_API_Error_Codes&oldid=1204783"