License/LICENSE/snip REST Callback

From Sni.ps Documentation

   The functionality specified for the License/LICENSE/Snip Callback is documented but not yet implemented.

REST Callbacks

license/{license}/snip

Returns a list of all snips with a given license type. The license argument is ignored for this callback.

Optional Arguments

type

The type or list of types to use for filtering the list of returned snips. Use a comma separated list to specify more than one type and prefix the list with an ! to instead find all snips not of that type(s).

Default: null

Example: type=image

Example: type=image,video

Example: type=!video

user

The user's id or ids which are used for filtering whose snips you would like returned. Use a comma separated list to specify more than one uid and prefix the list with an ! to instead find all snips not by that user(s).

Default: null

Example: user=8

Example: user=54,112

Example: user=!13

tag

One or more tags you would like to use to narrow down the list of snips. Use a comma separated list to specify more than one tag and prefix the list with an ! to instead find all snips that do not have that tag(s).

Default: null

Example: tag=cat

Example: tag=rock,banjo

Example: tag=!rickroll

attribution_path

The URL from which the snip originated. Can be simply the site domain.

Default: null

Example: attribution_path=flickr.com

min_date, max_date

The minimum and maximum for the date range for when the snips were created. Given in the format of a 32bit UNIX timestamp (the amount of seconds since Jan 1st, 1970).

Default: null

Example: min_date=1199163600 - Midnight, New Years Eve of 2008

tag_logic

The type of join used when more than one tag is specified.

Default: AND

Options: AND and OR

Example: tag_logic=OR

sort

The order in which the snips will be return.

Default: date

Options: date and popularity

Example: sort=popularity

limit

The maximum number of snips to return per page.

Default: 20

Maximum: 100

Example: limit=5

page

For result lists that have multiple pages worth of results, used to determine which page of results you would like returned.

Default: 1

Example: page=8