REST API v4: PUT profile fields

Om de velden van een profiel bij te werken, moet je een HTTP PUT request sturen naar de volgende URL:

https://api.copernica.com/v4/profile/$id/fields

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

Body data

De nieuwe veldwaardes moet je als body data aan je request meegeven. Deze data bestaat simpelweg uit de veldnamen die je wilt veranderen, en hun nieuwe waardes. Als je de data als JSON data verstuurt, moet je dus een object met als keys de veldnamen en als values de veldwaardes versturen.

Als je gebruik maakt van een traditioneel x-www-form-urlencoded formaat, dan moeten de variabelen de namen van de te wijzigen velden bevatten, en de waardes van die variabelen zijn de nieuwe waardes van de profielvelden.

Voorbeeld in JSON

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

{
    "firname": "John",
    "lastname": "Doe"
}

Voorbeeld in PHP

Het volgende PHP script demonstreert hoe je de API methode kunt aanroepen.

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

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

// data voor de methode
$data = array(
    'firstname' =>  'John',
    'lastname'  =>  'Doe',
    'email'     =>  'johndoe@example.com'
);

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

Dit voorbeeld vereist de REST API klasse.

Meer informatie