Difference between revisions of "HTTP API/Bot Commands/inventory give"

From SmartBots Developers Docs
Jump to: navigation, search
(Created page with "<onlyinclude>Commands bot to send an inventory item or folder to specific avatar.</onlyinclude> {{API Variables Table}} {{API HTTP Required Vars|give_inventory}} {{API Vari...")
 
Line 1: Line 1:
 +
{{DISPLAYTITLE: give_inventory (HTTP Bot Command)}}
 
<onlyinclude>Commands bot to send an inventory item or folder to specific avatar.</onlyinclude>
 
<onlyinclude>Commands bot to send an inventory item or folder to specific avatar.</onlyinclude>
  

Revision as of 10:01, 29 June 2016

Commands bot to send an inventory item or folder to specific avatar.

Variables

The following table shows input values (you send them with the API call) and returned output values.

Variable Required Description
Input basic parameters:
action yes = give_inventory
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:
avatar yes The avatar UUID.
object yes The inventory or folder UUID of the item. Use the Personal Bot Control Panel or listinventory API command to get this UUID.
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.

Error messages

Bot checks the permissions of the item before doing the delivery. The following error message is being returned if object is no-trans: 

transfer permission not set

This does not apply for folders. Empty folder is being delivered if no transferable items found.

Comments

  1. The inventory is loading each time your bot restarts. Allow about 60 seconds for inventory to completely load.
  2. Bot automatically recognizes the inventory folders and delivers them accordingly.
  3. The commands freezes for about 15 seconds if object UUID is not exists in bot's inventory. To avoid this make sure you are using correct UUIDs.


<< return back to Bot commands

(Miss an API call or parameter? Submit your request in forum)

Retrieved from "https://www.mysmartbots.com/dev/docs/index.php?title=HTTP_API/Bot_Commands/inventory_give&oldid=246"