Difference between revisions of "HTTP API/Doing HTTP API Calls"

From SmartBots Developers Docs
Jump to: navigation, search
Line 10: Line 10:
 
== Passing parameters to API URL ==
 
== Passing parameters to API URL ==
  
Imagine you need to call [[HTTP_API/Bot_Commands/say_chat_channel|say_chat_channel]] command to say something in local chat.
+
For example, you want to call the [[HTTP_API/Bot_Commands/say_chat_channel|say_chat_channel]] command to say something in local chat.
  
 
# Take the Bot API URL: https://api.mysmartbots.com/api/bot.html
 
# Take the Bot API URL: https://api.mysmartbots.com/api/bot.html
Line 31: Line 31:
 
   [HTTP_METHOD,"POST"], params);
 
   [HTTP_METHOD,"POST"], params);
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
You may also use [[HTTP_API/LSL_Helper_Functions|smartbotsAPI]] LSL helper function.
  
 
== Parsing HTTP Reply ==
 
== Parsing HTTP Reply ==

Revision as of 09:01, 24 January 2018

To invoke HTTP API command, you have to call SmartBots API URL with required parameters. See the full list of HTTP Bot commands here.

The request can be either GET or POST. The returned value format is described down below.

API call constructor

https://www.mysmartbots.com/api/testing.html - compose and test API queries using simple web form

Passing parameters to API URL

For example, you want to call the say_chat_channel command to say something in local chat.

  1. Take the Bot API URL: https://api.mysmartbots.com/api/bot.html
  2. Add required parameters
  3. Parse the response

The resulting query looks like this:

string params = llDumpList2String([
  "action="  + "say_chat_channel",
  "apikey="  + llEscapeURL(yourApiKey),
  "botname=" + llEscapeURL("YourBot Resident"),
  "secret="  + llEscapeURL(botSecretCode),
  "channel=" + "0",
  "message=" + llEscapeURL("Hello there!")
  ],"&");

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

You may also use smartbotsAPI LSL helper function.

Parsing HTTP Reply

HTTP APIs return either JSON or URL-encoded string (by your choice). Use "dataType=json" input parameter.

JSON (added Jan 2018)

The reply is being returned as a JSON string:

{
  "result": "FAIL",
  "resulttext": "BOT NOT EXISTS"
}

URL-encoded string

The reply is being returned as a set of variables joined in the same way as URL parameters:

result=FAIL&resulttext=BOT%20NOT%20EXISTS

Standard reply variables

There are two standard return variables:

  • result - takes one of two values:
    OK - command completed successfully
    FAIL - command failed
  • resulttext - contains the detailed explanation of failed commands

Other return variables may contain the query results (for example, "groups" for listgroups).

See also

Refer to HTTP API page for information on API commands available.