I’ve altered the SL Search API to always return the “url” field, and also replaced the “uuid” field for events (which returned incorrect data) with an “id” field that correctly marks the ID.
All current bugs in regards to returning blank or null fields have been fixed. In addition, I have added to the URLs for the search (actually it did this before, but I forgot to document it)
It can now accept the following format:
http://services.katharineberry.co.uk/search/search/(main|teen|mature)[/(all|classifieds|events|groups|people|places|wiki)]/search+term[/page-number]
The new parameter is in bold, and is entirely optional. It sets the category through which to search. Some example URLs:
- http://services.katharineberry.co.uk/search/search/teen/test+search - A search for “test search” on the TG
- http://services.katharineberry.co.uk/search/search/teen/groups/Group - A search for “Group” in all TG groups
- http://services.katharineberry.co.uk/search/search/teen/places/Land/2 - Page 2 (results 11-20) of a search for “Land” in all TG places
- http://services.katharineberry.co.uk/search/search/main/test+search - A search for “test search” on the MG
- http://services.katharineberry.co.uk/search/search/mature/test+search - A search for “test search” on the MG, with mature results enabled.
Search results will now return an object that looks something like this (ficticious search):
{
success: true,
results: [
{
type: "wiki",
url: "http://wiki.secondlife.com/wiki/Some_wiki_page",
name: "Some wiki page",
summary: "Excerpt from some wiki page..."
},
{
type: "place",
uuid: "e7b6d188-9f88-7a04-c066-4caa8e2b3fb6",
url: "http://teen.world.secondlife.com/place/e7b6d188-9f88-7a04-c066-4caa8e2b3fb6",
name: "Teen Grid's Party Event Area",
summary: "Host parties for new coming/outgoing friends! Or just chill, hangout and relax!"
},
{
"type":"event",
"id":"1234567",
"url":"http://teen.world.secondlife.com/event/1234567",
"name":"Sample Event",
"summary":"This is a test event that doesn't actually exist."
}
]
}
Residents, places, groups and classifieds will follow the format of “place” above. Events will follow that of “event” above.
Everything else will be in the format of the “wiki” entry.
Data from /place/ looks like this (edited output from.. oops, lost the URL):
{
success:true,
name: "Teen Grid's Party Event Area",
image: "9a7e13c0-b8bc-1885-9183-a2123c5c5dbb",
category: "Linden Location",
region: {
name: "Dougall",
uuid: "236910c3-cc59-ae3d-3594-4c2bdf9bc3b8"
},
position: {
x: 187,
y: 64,
z: 31
},
description: "Host parties for new coming/outgoing friends! Or just chill, hangout and relax! Host all your parties here!",
owner: {
group: false,
name: "Governor Linden",
uuid: 3d6181b0-6a4b-97ef-18d8-722652995cf1
},
objects: [
[
{
price: 10,
name: "Test Object",
description:"Object added to show object result format",
position: {
x: 141,
y: 37,
z: 28
}
}
]
}
Resident results look like this (edited output from http://services.katharineberry.co.uk/search/resident/16459c45-227a-4a4a-ac4c-5badfac9ac65):
{
success: true,
name: "Alister Harrington",
image: "00000000-0000-0000-0000-000000000000", /* Were this person to have a profile image, it would be here. */
description: "Alister Harrington - Well, I'm Alister. I'm 15, I make boats. That's about it really.",
born: "2005-06-08",
picks: [
{
uuid: "09545df4-0fae-7561-7473-d11c164d7c71", /* These UUIDs are places - although many of them don't seem to work. */
name: "1 - First poast.",
description: "And it rocks."
},
{
uuid: "b1f87754-5ac3-d96a-8ff1-ccb7240f3489",
name: "8 - Quotes 7",
description: "[Storm at the Eye4You College Fair]
[13:31] Storm Basiat: So
[13:31] Stephanie Carducci is Online
[13:31] Saryn Fanwood: sometimes I wonder
[13:31] Saryn Fanwood: :)
[13:31] Storm Basiat: Welcome to another speach
[13:31] Libby Beam: :)
[13:32] Storm Basiat: We will try and make this quick as possable as i hate speaches
[13:32] Storm Basiat: becuase im crap at it"
}
]
}
Classifieds look like this: (from http://services.katharineberry.co.uk/search/classified/149b8d14-53e6-d125-53e8-4f64c5435623)
{
success: true,
name: "Wolf Quadrupeds!",
image: "4c76a073-affd-9b69-0016-923296a79a84",
description: "One of the most realistic wolf quad's on the Teen Grid!
comes in black, brown, white and grey
change the color of the eyes with a command
and change the direction of the ears with a hud ^.^
price, 800L
Now selling limited halloween wolf quads!
comes with fangs, wings horns and glowing eyes >:D
comes in green, purple, orange, yellow and pink.
price, 700L
key words: wolf avatar avatars wolves animals furry furries av avies nature halloween costume",
price: 200,
region: {
uuid: "ccb75d6a-13c1-edbb-bf00-c70b65e50117",
name: "Nailsworth"
},
place: {
uuid: "0973bff5-dd79-89c6-f409-38f4a47afd8c",
name: "Wolf's Territory"
},
creator: {
uuid: "0ea431a3-0a7c-41b4-af8b-e658e3aec93a",
name: "Blue Newcomb"
},
position: {
x: 101,
y: 218,
z: 49
}
}
Region data looks like this (from http://services.katharineberry.co.uk/search/region/ccb75d6a-13c1-edbb-bf00-c70b65e50117):
{
success: true,
parcels: [
{
uuid: "36c1e094-4b2b-06cc-eb3d-74eb5c3baf6d",
name: "Devin Jordans Dezines",
position: {
x: 26,
y: 22,
z: 22
}
},
{
uuid: "93f4d010-5158-fa12-76dd-07570d3354d0",
name: "HOUSEING DISTRICT",
position: {
x: 140,
y: 227,
z: 52
}
},
{
uuid: "e91c73c9-7d70-7f04-f205-61fec9e3329f",
name: "Beautiful Waterfront Land",
position: {
x: 157,
y: 69,
z: 26
}
}
],
name: "Nailsworth"
}
Events look like this (from <a href="http://services.katharineberry.co.uk/search/event/1030959">http://services.katharineberry.co.uk/search/event/1030959</a>)
{
success: true,
name: "Party@Club Red Inferno",
category: "Nightlife/Entertainment",
description: "come party at club red inferno and help us raise money to keep the land",
rating: "PG",
time: 1196535600,
length: 10800, /* This is in seconds. */
host: {
uuid: "b5fa82fa-ec0a-42dd-beac-be417dcdc91a",
name: "SkullKing Kidd"
},
region: {
uuid: "8264f163-71b7-fe56-80c6-e5163a2c5bdb",
name: "Bull"
},
place: {
uuid: "fff021c9-6bc1-d67e-6caa-540f74924f9d",
name: "CLUB RED INFERNO"
},
position: {
x: 151,
y: 15,
z: 21
}
}
This is a group (http://services.katharineberry.co.uk/search/group/6e9aa3c7-131e-0a99-f282-2d00e4ed69e8 - first result for a search for “group” in the category “groups”)
{
success: true,
name: "Info Trade Business Group",
image: "3cb1f189-9700-7f04-0b18-3fc8c9555723",
members: 203,
founder: {
uuid: "c4bf9d63-f318-4799-8497-b4a7fcd89ec2",
name: "Gabe Gallacher"
}
}
Note that many (if not all) TG groups seem to be missing for some reason. LL’s fault, not mine.
Popular places (from http://services.katharineberry.co.uk/search/popular/teen/5)
{
success: true,
results: [
{
uuid: "e1549fee-b9c6-1da0-47db-00aefc4eee51",
name: "Sandbox Cleans every 3 hours. SAVE WORK-NO WARNING",
traffic: 9796
},
{
uuid: "29563825-a6e5-5e56-2e2a-5605df6f114e",
name: "Jeffrey Land",
traffic: 7330
},
{
uuid: "213a5ed6-7d5f-cf0f-1f95-e78d0c900668",
name: "^ [ Atticus Tech Sky Mall ] ^ - Look Up - Vacancy 2nd floor",
traffic: 6253
},
{
uuid: "6e93da51-07b8-574e-c615-c5d9fe805809",
name: "Sandbox Cleans every 3 hours. SAVE WORK-NO WARNING",
traffic: 5961
},
{
uuid: "260633c8-6287-4b51-aa54-4d00ff6c2bbb",
name: "WEAPONS TESTING SANDBOX - Wipes every 3 hours",
traffic: 5872
}
]
}