REST API v1: PUT profile fields

Waarschuwing: Je bekijkt nu het overzicht voor de oude versie van onze API. Wij raden aan om onze laastste versie van de API te gebruiken.

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

https://api.copernica.com/v1/profile/$id/fields?access_token=xxxx

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

Het volgende PHP script demonstreert hoe je de API methode kunt aanroepen. In de API call wordt een profiel met ID 1234 aangepast.

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

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

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

// voer het verzoek uit
$api->put("profile/1234/fields", array(), $data);

Dit voorbeeld vereist de REST API class.

Meer informatie