REST API v4 condities: Field

Condities zijn kleinere onderdelen van regels. Er hoeft maar aan een conditie van een regel te worden voldaan om aan de regel te voldoen. Elke conditie heeft specifieke eigenschappen.

Dit artikel gaat over de field conditie. Als je op zoek bent naar andere type condities kun je deze vinden onder het kopje Meer informatie.

Eigenschappen

  • comparison: vergelijk type voor fieldconditie. Zie de comparison types tabel.
  • field: veld om te vergelijken met waarde.
  • value: waarde om mee te vergelijken. (Aanpassing hiervan reset other-field).
  • other-field: ander veld om field mee te vergelijken. Als deze is ingesteld wordt value niet gebruikt.
  • numeric-comparison: boolean value om aan te geven of value numeriek wordt vergeleken.

Comparison types

De volgende tabel bevat de mogelijke waarden voor de comparison types en hun omschrijvingen.

Comparison types Omschrijving
equals Gelijk aan
not equals Ongelijk aan
contains Bevat
not contains Bevat niet
less Minder dan
more Meer dan
is email Is een mail
regexp Regex
is-numeric Is numeriek

Voorbeeld in JSON

De volgende JSON demonstreert hoe je de API methode kunt gebruiken:

{
    "type": "Field",
    "field": "has_children",
    "value": "yes"
}

Voorbeeld in PHP

Stel dat je door middel van een "has_children" veld, weet welke profielen kinderen hebben. In dit geval kun je een specifieke doelgroep e-mailen door een selectie te maken op de ouders. Je doet dit met de field conditie, die geldt wanneer dit voorbeeldt geldt. 

// vereiste module
require_once("CopernicaRestAPI.php");

// maak een API object met je eigen token
$api = new CopernicaRestAPI("your-access-token", 4);

$data = array(
    // selecteer field conditie
    'type' => 'Field',

    // selecteer veld
    'field' => 'has_children',

    // stel waarde in
    'value' => 'yes',
);

// voer het verzoek uit
$result = $api->post("rule/{$regelID}/conditions", $data);

// print het resultaat
print_r($result);

Dit voorbeeld vereist de REST API klasse.

Meer informatie