REST API v3: GET miniview
A method to request all metadata from a selection in a collection (miniview). This method does not support parameters. It is called by sending an HTTP GET request to the following URL:
https://api.copernica.com/v3/miniview/$id?access_token=xxxx
In this, $id
needs to be replaced by the numerical identifier or the
name of the collection you wish to request the miniselections for.
Returned fields
The method returns a JSON object with the following fields:
Variable | Description |
---|---|
ID | Unique numerical identifier. |
name | Name of the selection. |
description | Description of the selection. |
parent-type | Type of the parent: collection in this case. |
parent-id | ID of the view or collection. |
collection | ID of the collection this selection belongs to. |
last-built | Timestamp of the last time the view was built. |
intentions | Array with the intentions for the view (either 1 or null for email/sms/pdf). |
JSON example
The JSON for a miniview might look something like this:
{
"ID":"1525",
"name":"Miniselection",
"description":"",
"parent-type":"collection",
"parent-id":"21448",
"collection":"21448",
"last-built":"2019-06-19 00:48:37"
}
PHP example
The following example demonstrates how to use this method:
// dependencies
require_once('copernica_rest_api.php');
// change this into your access token
$api = new CopernicaRestAPI("your-access-token", 3);
// do the call, and print result
print_r($api->get("view/{$viewID}"));
The example above requires the CopernicaRestApi class.