Difference between revisions of "HTTP API/Doing HTTP API Calls"
Line 52: | Line 52: | ||
<syntaxhighlight lang="lsl"> | <syntaxhighlight lang="lsl"> | ||
+ | touch_start(integer total_number) { | ||
+ | llOwnerSay("Requesting bot status..."); | ||
+ | |||
+ | // See SmartBots "LSL Helper Functions" for smartbotsAPIJSON | ||
+ | smartbotsAPIJSON("status", []); | ||
+ | } | ||
+ | |||
http_response(key request_id, integer status, list metadata, string body) { | http_response(key request_id, integer status, list metadata, string body) { | ||
// llOwnerSay("API raw response: " + body); | // llOwnerSay("API raw response: " + body); |
Revision as of 14:41, 14 October 2019
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.
- Take the Bot API URL: https://api.mysmartbots.com/api/bot.html
- Add required parameters
- 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"
}
Use llJsonGetValue to get values from the response:
touch_start(integer total_number) {
llOwnerSay("Requesting bot status...");
// See SmartBots "LSL Helper Functions" for smartbotsAPIJSON
smartbotsAPIJSON("status", []);
}
http_response(key request_id, integer status, list metadata, string body) {
// llOwnerSay("API raw response: " + body);
string status = llJsonGetValue(body, ["status"]);
...
}
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 - can be one of:
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.