name2key
From SmartBots Developers Docs
Returns avatar UUID by Second Life name.
Variables
The following table shows input values (you send them with the API call) and returned output values.
Variable | Required | Description | ||
---|---|---|---|---|
This API command applies only for Standard bot | ||||
Input basic parameters: | ||||
action | yes | = name2key | ||
apikey | yes | Your personal developer's API key. | ||
botname | yes | Your bot's SL login. | ||
secret | yes | Bot access code of your bot. | ||
dataType | optional | Set to "json" to get JSON reply instead of URL-encoded string | ||
custom | optional | The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response. | ||
Input: | ||||
name | yes | the Second Life name of the avatar | ||
request_case | optional | set to 1 if you want to get the exact avatar name case from Second Life (see Name case) | ||
Output: | ||||
(to be received in http_response LSL event, see docs for details) | ||||
result | OK - command completed successfully FAIL - command failed | |||
resulttext | Detailed reason for the failure. | |||
custom | The value from input "custom" parameter. See above. | |||
key | Avatar's UUID | |||
name | Second Life name you've sent | |||
normalname | Second Life name, normalized (see "Return value") |
Return value
The command returns avatar's UUID by searching its Second Life name. Command returns two names:
- name - this is the name exactly as you've sent
- normalname - this is a "normalized" name: system adds "Resident" if necessary
Name case
SL ignores name case ("glaznah gassner" name is equal to "Glaznah GASSner"), so normalname may come lowercase.
If you want to get the exact name case from SL servers, set request_case to 1.
Example
1. Requesting the avatar UUID by Second Live name:
https://www.mysmartbots.com/api/bot.html?action=name2key&name=barKeeeper&...
Result:
name = barKeeeper normalname = barkeeeper resident key = 76e96174-ddcf-482f-86aa-c9394664082f
Or, with request_case=1:
name = barKeeeper normalname = BarKeeeper Resident key = 76e96174-ddcf-482f-86aa-c9394664082f
2. Looking for an unexistent avatar
https://www.mysmartbots.com/api/bot.html?action=name2key&name=ThisAvatarNotExists&...
Result:
result = FAIL resulttext = name lookup failed, ThisAvatarNotExists Resident normalname = ThisAvatarNotExists Resident name = ThisAvatarNotExists
<< return back to Bot commands
(Miss an API call or parameter? Submit your request in forum)