REST API v2: POST database views
Om een nieuwe selectie aan te maken, moet je een HTTP POST request sturen naar de volgende URL. De selectie wordt dan direct onder de database aangemaakt.
https://api.copernica.com/v2/database/$id/views?access_token=xxxx
De code $id
moet je vervangen door de numerieke identifier of de naam
van de database waar je een selectie aan wilt toevoegen. De naam van de selectie
moet als message body aan het HTTP request worden toegevoegd.
Beschikbare parameters
De volgende variabele moet in de body van de HTTP POST call worden geplaatst.
- name: naam van de nieuw aan te maken selectie (verplicht);
- description: beschrijving van de nieuwe selectie;
- parent-type: geeft aan of de selectie onder een onder selectie of de database is geplaatst;
- parent-id: id van de selectie/database waar de selectie onder valt;
- has-children: boolean value die aangeeft of er selecties onder deze selectie vallen;
- has-referred: boolean value om aan te geven of andere selecties naar deze selectie refereren;
- has-rules: boolean value om aan te geven of deze selectie regels heeft.
Voorbeeld in PHP
Het volgende PHP script demonstreert hoe je de API methode kunt aanroepen:
// vereiste scripts
require_once('copernica_rest_api.php');
// verander dit naar je access token
$api = new CopernicaRestAPI("your-access-token", 2);
// data voor de methode
$data = array(
'name' => 'mijn-selectie',
'description' => 'voorbeeld selectie',
'has-rules' => False
);
// voer het verzoek uit
$api->post("database/{$databaseID}/views", $data);
// bij een succesvolle call wordt het id van het aangemaakte verzoek teruggegeven
Dit voorbeeld vereist de REST API klasse.