REST API v4: GET database profiles

De methode om profielen uit een database op te vragen is een HTTP GET methode beschikbaar op het volgende adres:

https://api.copernica.com/v4/database/$id/profiles

De code $id moet je vervangen door de numerieke identifier of de naam van de database waar je de profielen van wilt opvragen. Deze methode kan traag zijn als de database veel profielen bevat. Om deze methode sneller te maken kan er gebruik gemaakt worden van de 'dataonly' parameter.

Beschikbare parameters

De volgende parameters kunnen aan de URL als variabelen worden toegevoegd:

  • start: Eerste ID om op te vragen
  • limit: Aantal profielen om op te vragen
  • total: Boolean. Geeft aan of het totale aantal profielen getoond moet worden. De methode is sneller wanneer dit op 'false' staat.
  • fields: Optionele parameter om condities voor profielen mee in te stellen.
  • orderby: Naam of id van het veld om op te sorteren (standaard is dit de ID).
  • order: Geeft de volgorde aan; oplopend ('asc') of aflopend ('desc').
  • dataonly: Boolean. Wanneer deze de waarde 'true' heeft worden alleen de ID, velden, interesses en datum van laatste aanpassing opgevraagd om de methode sneller te maken.

Paging

Meer over de start, limit en total parameters vind je in het artikel over paging.

Fields

De fields parameter kun je gebruiken om profielen te selecteren. Als je bijvoorbeeld alleen profielen wil opvragen waarbij de waarde van het veld "land" gelijk is aan "Nederland", kun je dat opgeven in deze parameter. Meer informatie over het gebruik van de fields parameter kun je vinden in een artikel over de fields parameter.

Sorteren

De parameter orderby geeft het veld aan waarop gesorteerd moet worden. In plaats van de naam of ID van het veld waarop je wilt sorteren, kun je ook een aantal speciale waardes aan de parameter orderby geven:

  • id: Profielen worden gesorteerd aan de hand van de ID (standaard).
  • random: De profielen worden willekeurig gesorteerd.
  • modified: De profielen worden gesorteerd op volgorde van de laatste aanpassing.

Geretourneerde velden

De methode retourneert een JSON object met de profielen onder het data veld. Elk profiel bevat de volgende velden:

  • ID: ID van het profiel
  • fields: Associatieve array van veldnamen en veldwaardes
  • interests: Array van de interesses van het profiel
  • database: ID van de database waarin het profiel is opgeslagen
  • secret: De "geheime" code die aan een profiel is gekoppeld
  • created: Tijdstip waarop het profiel in aangemaakt, in YYYY-MM-DD hh:mm:ss formaat
  • modified: Tijdstip waarop het profiel voor het laatst is bijgewerkt, in YYYY-MM-DD hh:mm:ss formaat
  • removed: Geeft aan of het profiel verwijderd is of niet

Sommige van deze velden worden niet teruggegeven als de dataonly parameter op 'false' staat.

JSON example

De JSON voor een profiel ziet er bijvoorbeeld zo uit:

{  
   "ID":"18381",
   "fields":{  
      "name":"Test",
      "email":"test@example.com",
   },
   "interests":[  
      "baseball",
      "soccer"
   ],
   "database":"7616",
   "secret":"e5903b43c08g011f7a1e1f2644f618be",
   "created":"2013-01-06 14:19:51",
   "modified":"2019-02-21 13:26:21",
   "removed":false
}

Voorbeeld in PHP

Het volgende PHP script demonstreert hoe je de API methode kunt aanroepen. Omdat we in het voorbeeld de CopernicaRestApi klasse gebruiken, hoef je je niet heel druk te maken over het vervangen van speciale tekens in de URL. Dat doet de klasse automatisch.

// vereiste scripts
require_once('CopernicaRestAPI.php');

// verander dit naar je acces token
$api = new CopernicaRestAPI("your-access-token", 4);

// parameters voor de methode
$parameters = array(
    'limit'     =>  100,
    'orderby'   =>  'country',
    'fields'    =>  array("age>16", "age<=65")
);

// voer de methode uit en print het resultaat
print_r($api->get("database/{$databaseID}/profiles", $parameters));

Dit voorbeeld vereist de REST API klasse.

Meer informatie