REST API v3: PUT profile interests

Om de interesses van een profiel te overschrijven, kun je een HTTP PUT request sturen naar de volgende URL:

https://api.copernica.com/v3/profile/$id/interests?access_token=xxxx

De code $id moet je vervangen door de numerieke identifier van het profiel waarvan je de interesses wilt veranderen. De nieuwe interesses van het profiel kun je in de body van het bericht plaatsen.

Body data

Je kunt op twee manieren body data aan dit request meesturen, en de wijze waarop je dit doet is van invloed op de manier waarop de methode werkt.

Als je een array van interessenamen meestuurt, dan worden alle interesses van het profiel overschreven. Alle huidige interesses worden uitgeschakeld, en alleen de interesses die in het array zijn opgenomen worden geactiveerd.

Je kunt ook een object sturen als body data. De keys van het object zijn dan de interessenamen, en de velden boolean waardes om te bepalen of de interesse aan of uit wordt geschakeld. Eventuele interesses die je niet in het object opneemt, worden automatisch uitgeschakeld.

Als je de huidige interesses niet wilt uitschakelen, maar slechts nieuwe toe wilt voegen kun je dat doen met deze methode.

Voorbeeld in JSON

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

{
    "voetbal": 1,
    "tennis": 1,
    "hockey": 0
}

Voorbeeld in PHP

Het volgende PHP script demonstreert hoe je de API methode kunt aanroepen. In de API call worden de interesses van een profiel met ID 4567 aangepast. Voor het eerste profiel worden de interesses "tennis" en "hockey" geactiveerd, en alle andere interesses (zelfs de interesses die niet expliciet zijn vermeld) uitgeschakeld (tweede methode). Daarna wordt voor het tweede profiel de interesse 'voetbal' geactiveerd en alle andere interesses uitgeschakeld (eerste methode).

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

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

    // data voor de methode
    $data = array(
        'voetbal'  =>  0,
        'tennis'    =>  1,
        'hockey'    =>  1
    );

    // voer het verzoek uit
    $api->put("profile/{$profielID1}/interests", $data);

    // data voor het tweede verzoek
    $data = array('voetbal');

    // voer het verzoek uit
    $api->put("profile/{$profielID2}/interests", $data);

Dit voorbeeld vereist de REST API klasse.

Meer informatie