Difference between revisions of "HTTP API/Bot Commands/key2name"
From SmartBots Developers Docs
(→Return value) |
|||
| (One intermediate revision by the same user not shown) | |||
| Line 8: | Line 8: | ||
{{API Variable Group|Input}} | {{API Variable Group|Input}} | ||
{{API Variable|key|yes}} the UUID of the avatar | {{API Variable|key|yes}} the UUID of the avatar | ||
| + | {{API Variable|request_case|no}} set to 1 if you want to get SL name in exact case (otherwise name may come in lower case). | ||
{{API Variable Group|Output}} | {{API Variable Group|Output}} | ||
| Line 25: | Line 26: | ||
<syntaxhighlight lang="http"> | <syntaxhighlight lang="http"> | ||
| − | + | https://www.mysmartbots.com/api/bot.html?action=key2name&key=76e96174-ddcf-482f-86aa-c9394664082f&... | |
</syntaxhighlight> | </syntaxhighlight> | ||
Latest revision as of 14:10, 7 September 2017
Returns avatar Second Life name by UUID. The command works in opposition to name2key.
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 | = key2name | ||
| 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: | ||||
| key | yes | the UUID of the avatar | ||
| request_case | optional | set to 1 if you want to get SL name in exact case (otherwise name may come in lower 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 | The UUID you've sent | |||
| name | Second Life name of the avatar | |||
Return value
The command returns an avatar's name by searching UUID key. Also check name2key command.
Example
Requesting the avatar Second Live name by UUID:
https://www.mysmartbots.com/api/bot.html?action=key2name&key=76e96174-ddcf-482f-86aa-c9394664082f&...
Result:
name = BarKeeeper Resident key = 76e96174-ddcf-482f-86aa-c9394664082f
<< return back to Bot commands
(Miss an API call or parameter? Submit your request in forum)
