Difference between revisions of "HTTP API/Bot Commands/parcel info update"

From SmartBots Developers Docs
Jump to: navigation, search
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE: parcel_info_update}}
 
{{DISPLAYTITLE: parcel_info_update}}
−
<onlyinclude>Update parcel details</onlyinclude>
+
<onlyinclude>Update parcel details, including the name, description and selling options</onlyinclude>
 +
 
 +
<syntaxhighlight lang="lsl">
 +
// See "LSL Helper Functions" page for this function
 +
smartbotsAPI("parcel_info_update", [
 +
  "x", 30,
 +
  "y", 60,
 +
  "name", "The new name of the parcel",
 +
  "sale", "on",
 +
  "saleprice", 1500,
 +
  "sellto", "cd93067e-7c4e-41c0-ba91-be01f4bafe35"
 +
]);
 +
</syntaxhighlight>
  
 
{{API Variables Table}}
 
{{API Variables Table}}
Line 9: Line 21:
 
{{API Variable|x|no}} the X coordinate of the parcel (default - at bot's position)
 
{{API Variable|x|no}} the X coordinate of the parcel (default - at bot's position)
 
{{API Variable|y|no}} the Y coordinate of the parcel (default - at bot's position)
 
{{API Variable|y|no}} the Y coordinate of the parcel (default - at bot's position)
−
{{API Variable|''item1''|yes}} the parcel entry to update (see the list below and examples)
+
{{API Variable|name|no}} The parcel name
−
{{API Variable|''item2''|optional}} another entry
+
{{API Variable|description|no}} The parcel description
−
{{API Variable|''item3''...|optional}} and so on
+
{{API Variable|musicurl|no}} The parcel music URL
 +
{{API Variable|sale|no}} Set to "on" to set land for sale, "off" to stop selling
 +
{{API Variable|saleprice|no}} The selling price
 +
{{API Variable|sellto|no}} The person UUID allowed to purchase this parcel
 +
{{API Variable|sellobjects|no}} Set to "on" to allow selling objects with the parcels ("off" to disallow)
 +
{{API Variable|snapshot|no}} The UUID of the picture to be set as a parcel image
 +
{{API Variable|landingpoint|no}} The parcel landing point, format: "X/Y/Z"
 +
{{API Variable|landingrouting|no}} The landing restrictions on the parcel, one of:
 +
 
 +
* Direct - land anywhere
 +
* LandingPoint - teleport to landing point only
 +
* None - teleport is blocked
  
 
{{API Variable Group|Output}}
 
{{API Variable Group|Output}}
Line 18: Line 41:
 
{{API Variables Table End}}
 
{{API Variables Table End}}
  
−
== Available parcel entries ==
+
== Permissions ==
  
−
The available parcel entries to update:
+
Your bot has to own the parcel, or have some of the permissions:
  
−
;name
+
* Parcel identity > "Change parcel name, description, and 'Moderate Content' setting"
−
: The parcel name
+
* Parcel settings > "Change music & media settings"
 +
* Parcel Management > "Set land for sale info"
  
−
;description
 
−
: The parcel description
 
  
−
;musicurl
+
[[Image:Parcel permissions.png|center|link=]]
−
: The parcel music URL
+
  
−
;sale
 
−
: Set to "on" to set land for sale, "off" to stop selling
 
  
−
;saleprice
+
'''IMPORTANT:''' SL requires you to re-log avatar when you change the parcel group abilities. Thus, relog bot after changing them.
−
: The selling price
+
  
−
;sellto
+
== Selling parcel ==
−
: The person UUID allowed to purchase this parcel
+
  
−
;sellobjects
+
This function is being used to set the sell price of the parcel:
−
: Set to "on" to allow selling objects with the parcels ("off" to disallow)
+
  
−
;snapshot
+
<syntaxhighlight lang="lsl">
−
: The UUID of the picture to be set as a parcel image
+
// See "LSL Helper Functions" page for this function
 +
smartbotsAPI("parcel_info_update", [
 +
  // No x and y given, this sell parcel under the bot
 +
  "sale", "on",
 +
  "saleprice", 1500,
 +
  // This is an optional parameter:
 +
  "sellto", "cd93067e-7c4e-41c0-ba91-be01f4bafe35"
 +
]);
  
−
;landingpoint
+
== Checking parcel update results ==
−
: The parcel landing point, format: "X/Y/Z"
+
  
−
;landingrouting
+
SL does not notify bot if parcel update was successful.
−
: The landing restrictions on the parcel, one of:<br>Direct - land anywhere<br>LandingPoint - teleport to landing point only<br>None - teleport is blocked
+
  
−
;flags
+
Thus, to ensure the results, bot
−
: Internal parcel flags, one or more from the list below. Combined using comma (",")
+
  
−
=== Flags ===
+
# updates the parcel,
 +
# then re-reads the parcel details from SL and compares them with expected values.
  
−
== Permissions ==
+
If your bot lacks any permissions (for example, "Set landing point and set teleport routing"), then expected parcel data won't match the actual parcel details. And you get an error from API.
  
−
Your bot has to own the parcel, or have some of the permissions:
+
== Return values ==
  
−
* Parcel identity > "Change parcel name, description, and 'Moderate Content' setting"
+
Use [https://www.mysmartbots.com/api/testing.html API testing suite] to test this API function.
−
* Parcel settings > "Change music & media settings"
+
−
* Parcel Management > "Set land for sale info"
+
  
−
'''IMPORTANT:''' SL requires you to re-log avatar when you change the parcel group abilities. Thus, relog bot after changing them.
+
[[Image:Parcel update api.png|center|link=]]
  
−
== Return values ==
 
  
−
The command returns ''result=OK'' if parcel update succeed.  
+
The command returns  
 +
 
 +
result=OK
 +
 
 +
if parcel update succeed.  
  
 
{{HTTP API Bot - standard footer}}
 
{{HTTP API Bot - standard footer}}

Latest revision as of 16:47, 16 January 2020

Update parcel details, including the name, description and selling options 

// See "LSL Helper Functions" page for this function
smartbotsAPI("parcel_info_update", [
  "x", 30,
  "y", 60,
  "name", "The new name of the parcel",
  "sale", "on",
  "saleprice", 1500,
  "sellto", "cd93067e-7c4e-41c0-ba91-be01f4bafe35"
]);

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 = parcel_info_update
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:
x optional the X coordinate of the parcel (default - at bot's position)
y optional the Y coordinate of the parcel (default - at bot's position)
name optional The parcel name
description optional The parcel description
musicurl optional The parcel music URL
sale optional Set to "on" to set land for sale, "off" to stop selling
saleprice optional The selling price
sellto optional The person UUID allowed to purchase this parcel
sellobjects optional Set to "on" to allow selling objects with the parcels ("off" to disallow)
snapshot optional The UUID of the picture to be set as a parcel image
landingpoint optional The parcel landing point, format: "X/Y/Z"
landingrouting optional The landing restrictions on the parcel, one of:
  • Direct - land anywhere
  • LandingPoint - teleport to landing point only
  • None - teleport is blocked
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.

Permissions

Your bot has to own the parcel, or have some of the permissions:

  • Parcel identity > "Change parcel name, description, and 'Moderate Content' setting"
  • Parcel settings > "Change music & media settings"
  • Parcel Management > "Set land for sale info"


Parcel permissions.png


IMPORTANT: SL requires you to re-log avatar when you change the parcel group abilities. Thus, relog bot after changing them.

Selling parcel

This function is being used to set the sell price of the parcel: 

// See "LSL Helper Functions" page for this function
smartbotsAPI("parcel_info_update", [
  // No x and y given, this sell parcel under the bot
  "sale", "on",
  "saleprice", 1500,
  // This is an optional parameter:
  "sellto", "cd93067e-7c4e-41c0-ba91-be01f4bafe35" 
]);

== Checking parcel update results ==

SL does not notify bot if parcel update was successful.

Thus, to ensure the results, bot 

# updates the parcel,
# then re-reads the parcel details from SL and compares them with expected values.

If your bot lacks any permissions (for example, "Set landing point and set teleport routing"), then expected parcel data won't match the actual parcel details. And you get an error from API.

== Return values ==

Use [https://www.mysmartbots.com/api/testing.html API testing suite] to test this API function.

[[Image:Parcel update api.png|center|link=]]


The command returns 

 result=OK

if parcel update succeed. 

{{HTTP API Bot - standard footer}}

{{NavMenu}}

__NOTOC__
Retrieved from "https://www.mysmartbots.com/dev/docs/index.php?title=HTTP_API/Bot_Commands/parcel_info_update&oldid=1875"