HTTP API

From SmartBots Developers Docs
Revision as of 08:29, 21 December 2016 by Gg (Talk | contribs)

Jump to: navigation, search

HTTP API allows controlling SL groups and Second Life bots using HTTP queries. The query can be send from SL object (LSL script) or online:

string params = llDumpList2String([
  "action="  + "get_balance",

  "apikey="  + llEscapeURL(sbApiKey),
  "botname=" + llEscapeURL(sbBotName),
  "secret="  + llEscapeURL(sbBotAccessCode)
], "&");

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

Check HTTP API examples to see how to control your bot from LSL.

API Types

There are two types of HTTP API at SmartBots. Open one of the following pages for complete list of the commands:

  1. HTTP API/Simple Groups API (easy-to-use API to control group invitations)
  2. HTTP API/Bot Commands (complex routines to fully control your bot)

Simple Group API allows you sending group invitations, eject members by sending simple API commands. The return result of the API is a plain text.

Bot API is slightly different: it provides more control over your bot, but you have to decode the API reply using llParseString2List and similar functions.

The basics

Basically the whole process consists of the following steps:

  1. Compose the query string and send it using llHTTPRequest (either GET or POST).
  2. Pickup the SmartBots reply using http_response.
  3. Decode the reply.

Read Doing HTTP API Calls for more info.