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

From Second Life Wiki
Jump to navigation Jump to search
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Supported API}}
{{Supported API}}
{{Multi-lang}}
{{Multi-lang}}
{{:Web Services Portal/navigation}}
{{:API Portal/navigation|reg}}
__TOC__
__TOC__
<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 26: Line 16:
! 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
|-
| 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
|-
|-
|40
| 58
|banned username
| invalid start_look_at_z
|Username is on the banned list
| start_look_at_z must be between -1 and 1
 
|-
|-
|50
| 59
|no perm last name id
| invalid agent_id
|You are not allowed to register a user with this last name id
| agent_id does not exist
 
|-
|-
|60
| 60
|invalid last name id
| invalid group id
|Last name id does not exist
| Failed to find group requested
 
|-
|-
|70
| 61
|invalid username
| invalid experience_id
|Username is not valid (must be alphanumeric between 2-31 characters)
| The requested experience does not exist
 
|-
|-
|80
| 62
|invalid password
| invalid avatar_id
|Password is not valid (must be between 6-16 characters)
| The requested avatar does not exist
 
|-
|-
|90
| 63
|invalid email
| invalid start_region_name
|Not a valid email
| Start location region does not exist
 
|-
|-
|95
| 64
|email exists
| invalid limited_to_estate
|Another user is currently using this email
| Limited estate cannot be set to an estate does not exist
 
|-
|-
|100
| 65
|invalid dob
| invalid url length
|Not a valid date
| Success and Error URLs must be 500 or fewer characters in length.
 
|-
|-
|110
| 66
|malformed dob
| invalid maximum maturity
|Date string is malformed
| Maximum maturity must be G(eneral), M(oderate), or A(dult).
 
|-
|-
|120
| 67
|user exists
| invalid email address
|User with specified username and last_name_id already exists
| Not a valid email
 
|-
|-
|130
| 70
|invalid start_region_name
| banned username
|Start location region does not exist
| Username is on the banned list
 
|-
|-
|140
| 71
|no perm start_region_name
| user exists
|You do not have permission to place a user in this region, because you do not own the estate that it is in
| User with specified username and last_name_id already exists
 
|-
|-
|150
| 72
|invalid limited_to_estate
| missing orientation island or start location
|Limited estate cannot be set to an estate does not exist
| 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
 
|-
|-
|160
| 100
|no perm limited_to_estate
| no perm user
|Limited estate cannot be set to an estate you do not own, besides mainland (estate_id = 1)
| only the original registrar of this user can set values for it
 
|-
|-
|170
| 101
|invalid region location options
| no perm last name id
|the region location options (e.g. local_x, local_y) are invalid
| You are not allowed to register a user with this last name id
 
|-
|-
|180
| 102
|missing orientation island or start location
| no perm experience
|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 administrators of an experience can add users to it
 
|-
|-
|190
| 103
|cannot register teen to non-teen grid
| no perm upgrade
|You cannot register a teen to a non-teen grid
| only original registrar of user can upgrade
 
|-
|-
|191
| 104
|cannot register adult to non-adult grid
| no perm start_region_name
|You cannot register an adult to a non-adult grid
| You do not have permission to place a user in this region, because you do not own the estate that it is in
 
|-
|-
|195
| 105
|cannot register underage user
| no perm limited_to_estate
|You cannot register a user into secondlife under 13
| Limited estate cannot be set to an estate you do not own, besides mainland (estate_id = 1)
 
|-
|-
|196
| 106
|underage user must be limited to estate
| invalid group perm
|Underage users (< 16 years old) must be limited to a private, G-rated estate
| not allowed to add members to this group
 
|-
|-
|210
| 107
|invalid start_local_x
| timeout perm user
|start_local_x must be between 0-256
| the registrar can no longer set values for this user
 
|-
|-
|220
| 108
|invalid start_local_y
| already logged
|start_local_y must be between 0-256
| this user has already logged in and cannot have values modified by their registrar
 
|-
|-
|230
| 109
|invalid start_local_z
| already activated
|start_local_z must be between 0-256
| this user has already activated their account
 
|-
|-
|240
| 130
|invalid start_look_at_x
| group set failed
|start_look_at_x must be between -1 and 1
| failed to set active group
 
|-
|-
|250
| 131
|invalid start_look_at_y
| group set exists
|start_look_at_y must be between -1 and 1
| the group operation attempted has already been completed
 
|-
|-
|260
| 300
|invalid start_look_at_z
| wrong type username
|start_look_at_z must be between -1 and 1
| username must be type string
 
|-
|-
|270
| 301
|invalid agent_id
| wrong type last_name_id
|agent_id does not exist
| last_name_id must be type integer
 
|-
|-
|280
| 303
|invalid account_type
| wrong type limited_to_estate
|account_type can only be set as 'Monthly', 'Quarterly', or 'Annual'
| limited_to_estate id must be type integer
 
|-
|-
|285
| 304
|no perm upgrade
| wrong type start_region_name
|only original registrar of user can upgrade
| start_region_name must be type string
 
|-
|-
|290
| 305
|cannot upgrade non-base user
| wrong type start_local_x
|users of 'Base' status can only be upgraded
| start_local_x must be type real
 
|-
|-
|295
| 306
|group set failed
| wrong type start_local_y
|failed to set active group
| start_local_y must be type real
 
|-
|-
|296
| 307
|invalid group perm
| wrong type start_local_z
|not allowed to add members to this group
| start_local_z must be type real
 
|-
|-
|297
| 308
|invalid group id
| wrong type start_look_at_x
|failed to find group
| start_look_at_x must be type real
 
|-
|-
|300
| 309
|wrong type username
| wrong type start_look_at_y
|username must be type string
| start_look_at_y must be type real
 
|-
|-
|310
| 311
|wrong type last_name_id
| wrong type start_look_at_z
|last_name_id must be type integer, or a string that represents an integer
| start_look_at_z must be type real
 
|-
|-
|320
| 312
|wrong type dob
| wrong type agent_id
|dob must be type string
| user id must be type UUID
 
|-
|-
|330
| 313
|wrong type email
| wrong type avatar_id
|email must be type string
| avatar id must be type UUID
 
|-
|-
|340
| 314
|wrong type password
| wrong type experience_id
|password must be type string
| experience id must be type UUID
 
|-
|-
|350
| 315
|wrong type limited_to_estate
| wrong type success_url
|limited_to_estate id must be type integer, or a string that represents an integer
| success url must be type URI
 
|-
|-
|360
| 316
|wrong type start_region_name
| wrong type error_url
|start_region_name must be type string
| error url must be type URI
 
|-
|-
|370
| 317
|wrong type start_local_x
| wrong type first
|start_local_x must be type float, or a string that represents a float
| 'first' must be type string
 
|-
|-
|380
| 318
|wrong type start_local_y
| wrong type last
|start_local_y must be type float, or a string that represents a float
| 'last' must be type string
 
|-
|-
|390
| 319
|wrong type start_local_z
| wrong type group_name
|start_local_z must be type float, or a string that represents a float
| group name must be type string
 
|-
|-
|400
| 320
|wrong type start_look_at_x
| wrong type marketing_emails
|start_look_at_x must be type float, or a string that represents a float
| marketing emails must be type boolean
 
|-
|-
|410
| 321
|wrong type start_look_at_y
| wrong type maximum_maturity
|start_look_at_y must be type float, or a string that represents a float
| maximum maturity must by 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.


|}
|}

Latest revision as of 10:42, 15 December 2022

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.
66 invalid maximum maturity Maximum maturity must be G(eneral), M(oderate), or A(dult).
67 invalid email address Not a valid email
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 error 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
320 wrong type marketing_emails marketing emails must be type boolean
321 wrong type maximum_maturity maximum maturity must by 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=1212880"