Difference between revisions of "HTTP API/Bot Commands/set http callback"
From SmartBots Developers Docs
| (2 intermediate revisions by the same user not shown) | |||
| Line 8: | Line 8: | ||
{{API Variable Group|Input}} | {{API Variable Group|Input}} | ||
| − | {{API Variable|url}} The URL of your HTTP script. This script will get POST requests from the bot. | + | {{API Variable|url|yes}} The URL of your HTTP script. This script will get POST requests from the bot. |
Send an empty URL to disable HTTP callback. | Send an empty URL to disable HTTP callback. | ||
| − | {{API Variable|events}} The events you want to receive, separated by a comma. See [[HTTP API/Bot Commands/set http callback/HTTP Bot Callback Events|HTTP Bot Callback Events]] for complete a list of events. | + | {{API Variable|events|yes}} The events you want to receive, separated by a comma. See [[HTTP API/Bot Commands/set http callback/HTTP Bot Callback Events|HTTP Bot Callback Events]] for complete a list of events. |
* Separate events by comma if you want to monitor several of them: ''events=group_invite,teleport_offer'' | * Separate events by comma if you want to monitor several of them: ''events=group_invite,teleport_offer'' | ||
* Specify ''events=all'' to monitor all possible events. | * Specify ''events=all'' to monitor all possible events. | ||
| + | {{API Variable|operation}} Operation: | ||
| + | |||
| + | * "add" (default) to add callback | ||
| + | * "remove" to remove callback | ||
{{API Variable Group|Output}} | {{API Variable Group|Output}} | ||
Latest revision as of 17:59, 2 September 2020
Specifies your HTTP callback script to receive bot events (invitations, IMs etc).
See HTTP Bot Callback for detailed information.
Variables
The following table shows input values (you send them with the API call) and returned output values.
| Variable | Required | Description | ||
|---|---|---|---|---|
| Input basic parameters: | ||||
| action | yes | = set_http_callback | ||
| 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: | ||||
| url | yes | The URL of your HTTP script. This script will get POST requests from the bot.
Send an empty URL to disable HTTP callback. | ||
| events | yes | The events you want to receive, separated by a comma. See HTTP Bot Callback Events for complete a list of events.
| ||
| operation | Operation:
| |||
| Output: | ||||
| (to be received in http_response LSL event, see docs for details) | ||||
| result | OK - command completed successfully FAIL - command failed | |||
| resulttext | Detailed reason for the failure. | |||
| custom | The value from input "custom" parameter. See above. | |||
<< return back to Bot commands
(Miss an API call or parameter? Submit your request in forum)
