/settings/addTrackingDomain
Add a new Tracking Domains
Example Call
<?php
try {
require_once 'PowerEmailMTA_PHP/PowerEmail.php';
$PowerEmail= new PowerEmail('owner_id', 'token', 'PowerEmailTES_APP_DOMAIN');
$result = $PowerEmail->settings->addTrackingDomain(domain);
print_r($result);
/*
Array
(
[status] => "success"
[message] => "Tracking Domain Added"
)
*/
} catch (PowerEmail_Error $e) {
// PowerEmailerrors are thrown as exceptions
echo 'A PowerEmailerror occurred: " . get_class($e) . " - " . $e->getMessage();
}
?>
Example Success Response
Array
(
[status] => "success"
[message] => "Tracking Domain Added"
)
Example Error Response
Array
(
[status] => "error",
[code] => "-1",
[name] => "AuthenticationError",
[message] => Token MissMatch,
)
| Parameters |
| owner_id* string |
a valid PowerEmailUser Id |
| token* string |
a valid token |
| PowerEmailTES_APP_DOMAIN* string |
a valid PowerEmailTES APP DOMAIN |
| domain* integer |
domain name |
* compulsory field
| Return Value: Success |
| struct |
the results of newly Added Domain
| status string |
always success |
| message string |
human readable message |
|
|
| Return Value: Error |
| struct |
the error results when attempt to add domain
| statusstring |
error |
| messagestring |
human readable message |
| type string |
one of the error type as bellow table |
|
|
| Error types |
| ValidationError |
The parameters passed to the API call are invalid or not provided when required. |
| GeneralError |
An unexpected errors occurred processing the request. PowerEmailDevelopers will be notified. |
| AuthenticationError |
Provided owner_id and token was not matched. |
/settings/checkTrackingDomain
check Tracking Domain
Example Call
<?php
try {
require_once 'PowerEmailMTA_PHP/PowerEmail.php';
$PowerEmail= new PowerEmail('owner_id', 'token');
$result = $PowerEmail->settings->checkTrackingDomain(domain);
print_r($result);
/*
Array
(
[status] => "success"
[domain] => "abc.com"
[valid_tracking] => "Yes"
[cname] => array(
[valid] => "Yes"
)
)
*/
} catch (PowerEmail_Error $e) {
// PowerEmailerrors are thrown as exceptions
echo 'A PowerEmailerror occurred: " . get_class($e) . " - " . $e->getMessage();
}
?>
Example Success Response
Array
(
[status] => "success"
[domain] => "abc.com"
[valid_tracking] => "Yes"
[cname] => array(
[valid] => "Yes"
)
Example Error Response
Array
(
[status] => "error",
[code] => "-1",
[name] => "AuthenticationError",
[message] => Token MissMatch,
)
| Parameters |
| owner_id* string |
a valid PowerEmailUser Id |
| token* string |
a valid token |
| PowerEmailTES_APP_DOMAIN* string |
a valid PowerEmailTES APP DOMAIN |
| domain* string |
doamin name |
* compulsory field
| Return Value: Success |
| struct |
the results of check Tracking Domain
| status string |
always success |
| message string |
human readable message |
| valid_tracking string |
value is Either 'Yes' OR 'No' |
| cname[]struct |
cname validation result
| valid string |
value is either 'Yes' OR 'No' |
|
|
|
| Return Value: Error |
| struct |
the error results when attempt check Tracking Domain
| statusstring |
error |
| messagestring |
human readable message |
| type string |
one of the error type as bellow table |
|
|
| Error types |
| ValidationError |
The parameters passed to the API call are invalid or not provided when required. |
| GeneralError |
An unexpected errors occurred processing the request. PowerEmailDevelopers will be notified. |
| AuthenticationError |
Provided owner_id and token was not matched. |
/settings/listTrackingDomain
List Tracking Domain
Example Call
<?php
try {
require_once 'PowerEmailMTA_PHP/PowerEmail.php';
$PowerEmail= new PowerEmail('owner_id', 'token', 'PowerEmailTES_APP_DOMAIN');
$result = $PowerEmail->settings->listTrackingDomain();
print_r($result);
/*
Array
(
[status] => "success"
[tracking_domain_list] => array(
array(
[domain] => "abc.com"
[create_date] => 67457775764
[cname] => array(
[valid] => "Yes"
)
),
array(
[domain] => "xyz.com"
[create_date] => 67457775891
[cname] => array(
[valid] => "Yes"
)
)
)
)
*/
} catch (PowerEmail_Error $e) {
// PowerEmailerrors are thrown as exceptions
echo 'A PowerEmailerror occurred: " . get_class($e) . " - " . $e->getMessage();
}
?>
Example Success Response
Array
(
[status] => "success"
[tracking_domain_list] => array(
array(
[domain] => "abc.com"
[create_date] => 67457775764
[cname] => array(
[valid] => "Yes",
)
),
array(
[domain] => "xyz.com"
[create_date] => 67457775891
[cname] => array(
[valid] => "Yes",
)
)
)
)
Example Error Response JSON
Array
(
[status] => "error",
[code] => "-1",
[name] => "AuthenticationError",
[message] => Token MissMatch,
)
| Parameters |
| owner_id* string |
a valid PowerEmailUser Id |
| token* string |
a valid token |
| PowerEmailTES_APP_DOMAIN* string |
a valid PowerEmailTES APP DOMAIN |
* compulsory field
| Return Value: Success |
| struct |
the results of List Tracking Domain
| status string |
always success |
| message string |
human readable message |
| tracking_domain_list[]struct |
information of single Tracking Domain
| domain string |
domain name |
| create_date integer |
create date in micro seconds |
| cname[]struct |
cname validation result
| valid string |
value is Either 'Yes' OR 'No' |
|
|
|
|
|
| Return Value: Error |
| struct |
the error results when attempt to List Tracking Domain
| status string |
error |
| message string |
human readable message |
| type string |
one of the error type as bellow table |
|
|
| Error types |
| ValidationError |
The parameters passed to the API call are invalid or not provided when required. |
| GeneralError |
An unexpected errors occurred processing the request. PowerEmailDevelopers will be notified. |
| AuthenticationError |
Provided owner_id and token was not matched. |
/settings/deleteTrackingDomain
Delete Tracking Domain
Example Request JSON
<?php
try {
require_once 'PowerEmailMTA_PHP/PowerEmail.php';
$PowerEmail= new PowerEmail('owner_id', 'token', 'PowerEmailTES_APP_DOMAIN');
$result = $PowerEmail->settings->deleteTrackingDomain(domain);
print_r($result);
/*
Array
(
[status] => "success"
[message] => "Tracking Domain Deleted"
)
*/
} catch (PowerEmail_Error $e) {
// PowerEmailerrors are thrown as exceptions
echo 'A PowerEmailerror occurred: " . get_class($e) . " - " . $e->getMessage();
}
?>
Example Success Response
Array
(
[status] => "success"
[message] => "Sending Domain Added"
)
Example Error Response
Array
(
[status] => "error",
[code] => "-1",
[name] => "AuthenticationError",
[message] => Token MissMatch,
)
| Parameters |
| owner_id* string |
a valid PowerEmailUser Id |
| token* string |
a valid token |
| PowerEmailTES_APP_DOMAIN* string |
a valid PowerEmailTES APP DOMAIN |
| domain* string |
domain name |
* compulsory field
| Return Value: Success |
| struct |
the results of Delete Tracking domain
| status string |
always success |
| message string |
human readable message |
|
|
| Return Value: Error |
| struct |
the error results when attempt to Delete Tracking Domain
| status string |
error |
| message string |
human readable message |
| type string |
one of the error type as bellow table |
|
|
| Error types |
| ValidationError |
The parameters passed to the API call are invalid or not provided when required. |
| GeneralError |
An unexpected errors occurred processing the request. PowerEmailDevelopers will be notified. |
| AuthenticationError |
Provided owner_id and token was not matched. |
