give_money_object

Commands the bot to send money (L$) to a specific object.
Also see the give_money command.

// See "LSL Helper Functions" page for this function
smartbotsAPI("give_money_object", [
  "object_uuid", "6e4f1662-19ec-b06c-7625-2c0c2595060f",
  "amount", 10,
  "object_name", ""
]);

Variables

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

Input basic parameters

Variable

Required

Description

action

yes

= give_money_object

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

Variable

Required

Description

object_uuid

yes

The UUID of the target object

amount

yes

The amount of L$ to send

object_name

optional

The object’s name (optional; see Comments)

Output

(To be received in *http_response* LSL event, see docs for details)

Variable

Description

result

OK - command completed successfully
FAIL - command failed

resulttext

Detailed reason for the failure

custom

The value from input "custom" parameter. See above

Comments

Second Life requires the object name to be sent with the query.
However, since 2015/04/02, the function works even if no object name is specified.

The bot and the target object must reside in the same region (sim).

Error messages

The bot returns either:

result=OK

on success, or:

result=FAIL
resulttext=text-string

to indicate a problem (e.g., insufficient balance).

Example

The following example sends L$10 to an object in-world:


string params = llDumpList2String([
  "action="  + "give_money_object",
  "apikey="  + llEscapeURL(sbApiKey),
  "botname=" + llEscapeURL(sbBotName),
  "secret="  + llEscapeURL(sbBotAccessCode),
  "object_uuid="  + "6e4f1662-19ec-b06c-7625-2c0c2595060f",
  "amount=" + "10",
  "object_name=" + ""
], "&");

llHTTPRequest("https://api.mysmartbots.com/api/bot.html",
  [HTTP_METHOD, "POST"], params);