REST API v4: POST database profile
The HTTP POST method to add a profile to an existing database is available at the following address:
https://api.copernica.com/v4/database/$id/profiles
In this, $id
should be replaced by the numerical identifier, the ID,
of the database you want to add a profile to.
Profile information needs to be added to the message body of the HTTP request.
After a successful call the ID of the created request is returned.
Please note that while POST and PUT are generally the same it is import to distinguish them in this case. This method posts a new profile, while PUT is the method to edit several profiles (see: editing multiple profiles).
Body data
Besides the parameters that you append to the URL, you must also include a request body in the POST request. The body has two optional components: 'fields' and 'interests'. Both will be added to the new profile. The interests can be added from a list ("football") or with an associative array ("football" => 1, "baseball" => 0). Fields must be an associative array.
Please note that this is a different input format than version 1 of this API call.
JSON example
The following JSON demonstrates how to use the API method:
{
"fields": {
"firstname": "John",
"lastname": "Doe",
"email": "johndoe@example.com"
},
"interests": {
"Football": 1,
"Baseball": 0
}
}
PHP example
The following PHP script demonstrates how to use the API method:
// dependencies
require_once('CopernicaRestAPI.php');
// change this into your access token
$api = new CopernicaRestAPI("your-access-token", 4);
// field values for the profile
$fields = array(
'firstname' => 'John',
'lastname' => 'Doe',
'email' => 'johndoe@example.com'
);
// interest values for the new profile
$interests = array(
'football' => 1,
'baseball' => 0
);
// defining the interests like this is also valid
$interests = array("football");
// the fields and interests together form the data for the
// call
$data = array(
'fields' => $fields,
'interests' => $interests
);
// do the call
$api->post("database/{$databaseID}/profiles", $data);
// return id of the created profile if successful
The example above requires the CopernicaRestApi class.