REST API v1: GET collection miniviews
Warning: You are viewing the documentation for the old REST API. We recommend using our latest version of the REST API.
What selections are to a database is what miniselections, or miniviews, are to a collection. To fetch the miniselections applied to this collection the following HTTP GET request can be used:
https://api.copernica.com/v1/collection/$id/miniviews?access_token=xxxx
The code $id
should be replaced by the ID of the collection you want to
fetch the miniviews of.
Available parameters
The following parameters can be added to the URL as variables:
- start: first miniselection to fetch
- limit: length of the batch to fetch
- total: boolean value for displaying the total amount of miniselections
More information on the meaning of these parameters can be found in the article on paging.
Returned fields
The method returns a list of miniselections. For each selection the following information is returned:
- ID: numerical ID of the miniselection
- name: name of the miniselection
- description: description of the miniselection
- parent-type: the parent-type is always the string "collection"
- parent-id: ID of the collection this miniselection belongs to
- collection: ID of the collection this miniselection belongs to
PHP example
The following PHP script demonstrates how to call the API method:
// dependencies
require_once('copernica_rest_api.php');
// insert your access token
$api = new CopernicaRestApi("your-access-token");
// parameters for the call
$parameters = array(
'limit' => 100
);
// execute the method and print the results
print_r($api->get("collection/1234/miniviews", $parameters));
The example above requires the CopernicaRestApi class.