View source for HTTP API/Bot Commands/sim access

{{DISPLAYTITLE: sim_access}}
<onlyinclude>Control access to the sim.</onlyinclude>

<syntaxhighlight lang="lsl">
smartbotsAPI("sim_access", [
  "avatar", UUID, 
  "operation", OPERATION,
  "all_estates", TRUE
]); // See "LSL Helper Functions" page for this function
</syntaxhighlight>

{{API Variables Table}}

{{API HTTP Required Vars|sim_access}}

{{API Variable Group|Input}}
{{API Variable|avatar|yes}} The resident to manage access for
{{API Variable|operation|yes}} The operation to perform. One of the following:
* ban - add to ban list
* unban - remove from ban list
* allow - add to allowed list
* disallow - remove from allowed list

{{API Variable|all_estates|no}} If TRUE (or 1), perform operation for all estates available for bot

{{API Variable Group|Output}}
{{API HTTP Standard Output}}

{{API Variables Table End}}

== Comments ==

* You have to teleport to the region first.
* To execute this function your bot needs to be an [http://wiki.secondlife.com/wiki/Estate_Manager Estate Manager].
* You '''don't need''' a "Sim Governor" add-on to use this function.

== Examples ==

Teleport to DuoLife region and ban BartenderJoe:

<syntaxhighlight lang="lsl">
// You need to adjust the vars below:
string sbApiKey = "...";
string sbBotName = "...";
string sbBotAccessCode = "...";

string myHome = "DuoLife/128/128/20";

// First, teleport to the desired region
string params = llDumpList2String([
  "action="  + "teleport",
  "location=" + llEscapeURL(myHome),
  "apikey="  + llEscapeURL(sbApiKey),
  "botname=" + llEscapeURL(sbBotName),
  "secret="  + llEscapeURL(sbBotAccessCode)
  ], "&");
 
llHTTPRequest("http://api.mysmartbots.com/api/bot.html",
  [HTTP_METHOD,"POST"], params);

// Then restart it:
params = llDumpList2String([
  "action="  + "sim_access",
  "avatar=" + "bc3af7d6-f089-4b57-b78e-473334af01cb",
  "operation=" + "ban",
  "all_estates=" + "0"
  ], "&");
 
llHTTPRequest("http://api.mysmartbots.com/api/bot.html",
  [HTTP_METHOD,"POST"], params);
</syntaxhighlight>

{{HTTP API Bot - standard footer}}

{{NavMenu}}

__NOTOC__