PHP

Choose Language

Tracking Domains Calls

Info! Do you have any questions on our Email API? Write to us at support@sendclean.com

/settings/addTrackingDomain

Add a new Tracking Domains

Example Call


<?php
    try {
        require_once 'SendCleanMTA_PHP/SendClean.php';
        $SendClean= new SendClean('owner_id', 'token', 'SendCleanTES_APP_DOMAIN');
        $result = $SendClean->settings->addTrackingDomain(domain);
        print_r($result);
        /*
        Array
        (
            [status] => "success"
            [message] => "Tracking Domain Added"
        )
        */
    } catch(SendClean_Error $e) {
        // SendCleanerrors are thrown as exceptions
        echo "A SendCleanerror 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 SendCleanUser Id
token* string a valid token
SendCleanTES_APP_DOMAIN* string a valid SendCleanTES APP DOMAIN
domain* string 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
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. SendCleanDevelopers will be notified.
AuthenticationError Provided owner_id and token was not matched.

/settings/checkTrackingDomain

check Tracking Domain

Example Call


<?php
    try {
        require_once 'SendClean.php';
        $SendClean= new SendClean(owner_id, token);
        $result = $SendClean->settings->checkTrackingDomain(domain);
        print_r($result);
        /*
        Array
        (
            [status] => "success"
            [domain] => "abc.com"
            [valid_tracking] => "Yes"
            [cname] => array(
                            [valid] => "Yes" 
                        )
        )
        */
    } catch(SendClean_Error $e) {
        // SendCleanerrors are thrown as exceptions
        echo "A SendCleanerror 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 SendCleanUser Id
token* string a valid token
SendCleanTES_APP_DOMAIN* string a valid SendCleanTES APP DOMAIN
domain* string domain 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
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. SendCleanDevelopers will be notified.
AuthenticationError Provided owner_id and token was not matched.

/settings/listTrackingDomain

List Tracking Domain

Example Call


<?php
    try {
        require_once 'SendCleanMTA_PHP/SendClean.php';
        $SendClean= new SendClean('owner_id', 'token', 'SendCleanTES_APP_DOMAIN');
        $result = $SendClean->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(SendClean_Error $e) {
        // SendCleanerrors are thrown as exceptions
        echo "A SendCleanerror 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


Array
(
    [status]=> "error"
    [code]=> -1
    [name]=> "AuthenticationError"
    [message]=> "Token MissMatch"
)
Parameters
owner_id* string a valid SendCleanUser Id
token* string a valid token
SendCleanTES_APP_DOMAIN* string a valid SendCleanTES 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. SendCleanDevelopers will be notified.
AuthenticationError Provided owner_id and token was not matched.

/settings/deleteTrackingDomain

Delete Tracking Domain

Example Call


<?php
    try {
        require_once 'SendCleanMTA_PHP/SendClean.php';
        $SendClean= new SendClean('owner_id', 'token', 'SendCleanTES_APP_DOMAIN');
        $result = $SendClean->settings->deleteTrackingDomain(domain);
        print_r($result);
        /*
        Array
        (
            [status] => "success"
            [message] => "Tracking Domain Deleted"
        )
        */
    } catch(SendClean_Error $e) {
        // SendCleanerrors are thrown as exceptions
        echo "A SendCleanerror occurred: " . get_class($e) . " - " . $e->getMessage();
    }
?>

Example Success Response


Array
(
    [status] => "success"
    [message] => "Tracking Domain Deleted"
)

Example Error Response


Array
(
    [status]=> "error"
    [code]=> -1
    [name]=> "AuthenticationError"
    [message]=> "Token MissMatch"
)
Parameters
owner_id* string a valid SendCleanUser Id
token* string a valid token
SendCleanTES_APP_DOMAIN* string a valid SendCleanTES 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. SendCleanDevelopers will be notified.
AuthenticationError Provided owner_id and token was not matched.