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.