Returns a list of a resident's picks.
The following table shows input values (you send them with the API call) and returned output values.
|This API command applies only for Standard bot|
|Input basic parameters:|
|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.|
|avatar||yes||Avatar UUID to fetch picks for|
|skipnames||optional||Skip pick (do not return) if its name contains this substring (case insensitive)|
|matchnames||optional||Return only picks which names contain this substring (case insensitive)|
|matchuuid||optional||Return pick with this parcel UUID only|
|(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.|
|total||The total number of picks (regardless of any filters, see below).|
|picks|| The list of resident's picks: parcel UUIDs and names.
This list may be affected by skip* and match* parameters. See the "Return value" section below.
Working with large lists
LSL llHttpRequest() function has a limitation on reply size (it is being cut to 2048 bytes, or 1024 Unicode characters). If the resident has a lot of picks, they may not fit into the http reply.
There are several solutions for this problem. Use the following parameters:
- skipnames - ignore picks which names contain this substring
- matchnames - list only picks which names contain a specific substring
- matchuuid - return specific pick by parcel UUID
total - variable contains the total number of resident's picks. It is not affected by skip* or match* parameters.
picks - the list of picks (probably filtered by skip* and match*): a string which contains the parcel UUIDs and pick names separated by newline ("\n"):
Parcel-UUID-1 name-of-the-pick-1 Parcel-UUID-2 name-of-the-pick-2 ...
Example request to get the resident's picks:
A response from the bot:
07300856-2d89-754e-dfb2-dd73553d76dc Earn2Life.com Discount Shop ff1dd581-7eea-8b1f-68f5-eab19046571d Earn2Life.com: Free Lindens & Jobs! 9e1c606a-c69c-5af0-cc35-017854b8ec12 SLBiz2Life Advertising: advertise here!
The same request, groups filtered by name (only those which contain "earn2life"):
Response from the bot:
07300856-2d89-754e-dfb2-dd73553d76dc Earn2Life.com Discount Shop ff1dd581-7eea-8b1f-68f5-eab19046571d Earn2Life.com: Free Lindens & Jobs!
(Miss an API call or parameter? Submit your request in forum)