REST API v4: GET miniview rule
Selections use rules to decide which profiles are included in the selection and which profiles are not. Profile that match at least on of the selection rules are included in the selection. To retrieve the properties and the conditions of a single rule in a selection from a collection (miniview) you can send an HTTP GET request to the following URL:
https://api.copernica.com/v4/miniview/$id/minirule/$id
The first $id
code should be replaced with the numeric identifier of the
selection from which you want to retrieve a rule. The second $id
parameter
should be the ID of the rule.
The returned properties
This method returns rule data. The following properties are returned:
- ID: numeric ID of the rule
- name: name of the rule
- view: ID of the selection to which the rule belongs
- disabled: boolean value whether the rule is disabled / not used to match profiles
- inverted: boolean value whether this is an inverted rule, meaning that profiles are included in the rule if they do not match the rule
- conditions: array of conditions in the rule.
A rule on its own contains conditions. For a profile to match a rule, it has to match all the conditions. The conditions property that is returned by this method holds an array of condition objects, with the following properties per condition:
- ID: numeric ID of the condition
- type: condition type
- rule: numeric ID of the rule to which the condition belongs
Based on the condition type, specific properties are set. For an overview of the supported conditions and the properties that they support, check the specific articles:
- Change conditions
- Date conditions
- DoubleField conditions
- Email conditions
- Field conditions
- Interest conditions
- LastContact conditions
- Miniview conditions
- SMS conditions
- Todo conditions
- Survey conditions
- Part conditions
- ReferView conditions
PHP example
The following script can be used to fetch the properties of rule 12 inside selection 1234:
// dependencies
require_once('CopernicaRestAPI.php');
// change this into your access token
$api = new CopernicaRestAPI("your-access-token", 4);
// do the call, and print result
print_r($api->get("miniview/{$miniviewID}/minirule/{$ruleID}"));
The example above requires the CopernicaRestApi class.