Social - Share - Search
/social/share/search
Searches the share collection
A detailed explanation of the share object can be found here.
Authentication
Required, see Auth - Login. You must be a member of one of the communities associated with a share to be able to access that share.
Arguments
Note: All of the following arguments are optional.
searchby
V0 release supports "community" or "person". The latter is only supported for admin users (except for obtaining only your shares, see below). If "searchby" is not specified, searches across all joined communities.
id
Comma separated list of community IDs, or a community regex (for "searchby=community"), or a list of email addresses or a list of ids (for "searchby=person"). If this is not specified for "person", it defaults to the calling user.
type
Comma separated list of (arbitrary string) share types. Example values: "dataset", "feed", "source", "query". "binary".
skip
Number of results to skip.
limit
Number of results to return.
searchParent
searches up the community tree for a given communityId (Note: this only works if searchby=community), defaults to false otherwise
nocontent
doesn't return the content from matching shares, only the metadata
Parameters
project_id (optional): the id of a share of type "infinite_project_config", this will filter the search to only communities active in this project. See projects documentation for more information
Example
http://infinite.ikanow.com/api/social/share/search
http://infinite.ikanow.com/api/social/share/search?type=feed
http://infinite.ikanow.com/api/social/share/search?searchby=person&id=user1@test.com,user2@test.com
http://infinite.ikanow.com/api/social/share/search?searchby=community&id=*system
Example Response
{
response:
{
action: "Share"
success: true
message: "Share returned successfully"
time: 41
}
data:
[
{
_id: "4e175bfeb8ed6403f48ea7e2"
created: "Jul 8, 2011 11:35:26 AM"
modified: "Jul 10, 2011 9:27:36 AM"
owner:
{
_id: "4d88d0f1f9a624a4b0c8bd71"
email: "jdoe@ikanow.com"
displayName: "John Doe"
}
type: "test"
title: "Test Share"
description: "Just a test of share functionality"
share: "random stuff that gets put in share"
communities: [
{
_id: "4d88d0f1f9a624a4b0c8bd71"
name: "John Doe's Personal Community"
},
{
_id: "4c927585d591d31d7b37097a"
name: "Infinit.e System"
comment: "Share with everyone!"
}
]
}
]
}