avatar_picks

From SmartBots Developers Docs
Jump to: navigation, search

Returns a list of a resident's picks.

Variables

The following table shows input values (you send them with the API call) and returned output values.

Variable Required Description.
This API command applies only for Standard bot
Input basic parameters:
action yes = avatar_picks
apikey yes Your personal developer's API key.
botname yes Your bot's SL login.
secret yes Bot access code of your bot.
custom no The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response.
Input:
avatar yes Avatar UUID to fetch picks for
skipnames no Skip pick (do not return) if its name contains this substring (case insensitive)
matchnames no Return only picks which names contain this substring (case insensitive)
matchuuid no Return pick with this parcel UUID only
Output:
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

Return value

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
...

Examples

Example request to get the resident's picks:

https://www.mysmartbots.com/api/bot.html?action=avatar_picks&avatar=cd93067e-7c4e-41c0-ba91-be01f4bafe35&...

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"):

https://www.mysmartbots.com/api/bot.html?action=avatar_picks&avatar=cd93067e-7c4e-41c0-ba91-be01f4bafe35&matchnames=earn2life&...

Response from the bot:

07300856-2d89-754e-dfb2-dd73553d76dc Earn2Life.com Discount Shop
ff1dd581-7eea-8b1f-68f5-eab19046571d Earn2Life.com: Free Lindens & Jobs!

<< return back to Bot commands