Tracking Domains Calls

/settings/addTrackingDomain

Add a new Tracking Domains

<?php
    try {
        require_once 'SarvMTA_PHP/Sarv.php';
        $sarv = new Sarv('owner_id', 'token', 'SarvTES_APP_DOMAIN');
        $result = $sarv->settings->addTrackingDomain(domain);
        print_r($result);
        /*
        Array
        (
            [status] => "success"
            [message] => "Tracking Domain Added"
        )
        */
    } catch(Sarv_Error $e) {
        // Sarv errors are thrown as exceptions
        echo "A sarv error occurred: " . get_class($e) . " - " . $e->getMessage();
    }
?>

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

Array
(
    [status]=> "error"
    [code]=> -1
    [name]=> "AuthenticationError"
    [message]=> "Token MissMatch"
)

Parameters
owner_id* string	a valid Sarv User Id
token* string	a valid token
SarvTES_APP_DOMAIN* string	a valid SarvTES 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. Sarv Developers will be notified.
AuthenticationError	Provided owner_id and token was not matched.

/settings/checkTrackingDomain

check Tracking Domain

<?php
    try {
        require_once 'Sarv.php';
        $sarv = new Sarv(owner_id, token);
        $result = $sarv->settings->checkTrackingDomain(domain);
        print_r($result);
        /*
        Array
        (
            [status] => "success"
            [domain] => "abc.com"
            [valid_tracking] => "Yes"
            [cname] => array(
                            [valid] => "Yes" 
                        )
        )
        */
    } catch(Sarv_Error $e) {
        // Sarv errors are thrown as exceptions
        echo "A sarv error occurred: " . get_class($e) . " - " . $e->getMessage();
    }
?>

Array
(
    [status] => "success"
    [domain] => "abc.com"
    [valid_tracking] => "Yes"
    [cname] => array(
                    [valid] => "Yes" 
                )
)

Array
(
    [status]=> "error"
    [code]=> -1
    [name]=> "AuthenticationError"
    [message]=> "Token MissMatch"
)

Parameters
owner_id* string	a valid Sarv User Id
token* string	a valid token
SarvTES_APP_DOMAIN* string	a valid SarvTES 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. Sarv Developers will be notified.
AuthenticationError	Provided owner_id and token was not matched.

/settings/listTrackingDomain

List Tracking Domain

<?php
    try {
        require_once 'SarvMTA_PHP/Sarv.php';
        $sarv = new Sarv('owner_id', 'token', 'SarvTES_APP_DOMAIN');
        $result = $sarv->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(Sarv_Error $e) {
        // Sarv errors are thrown as exceptions
        echo "A sarv error occurred: " . get_class($e) . " - " . $e->getMessage();
    }
?>  

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"
                                        )
                        )
                    )
)

Array
(
    [status]=> "error"
    [code]=> -1
    [name]=> "AuthenticationError"
    [message]=> "Token MissMatch"
)

Parameters
owner_id* string	a valid Sarv User Id
token* string	a valid token
SarvTES_APP_DOMAIN* string	a valid SarvTES 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. Sarv Developers will be notified.
AuthenticationError	Provided owner_id and token was not matched.

/settings/deleteTrackingDomain

Delete Tracking Domain

<?php
    try {
        require_once 'SarvMTA_PHP/Sarv.php';
        $sarv = new Sarv('owner_id', 'token', 'SarvTES_APP_DOMAIN');
        $result = $sarv->settings->deleteTrackingDomain(domain);
        print_r($result);
        /*
        Array
        (
            [status] => "success"
            [message] => "Tracking Domain Deleted"
        )
        */
    } catch(Sarv_Error $e) {
        // Sarv errors are thrown as exceptions
        echo "A sarv error occurred: " . get_class($e) . " - " . $e->getMessage();
    }
?>

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

Array
(
    [status]=> "error"
    [code]=> -1
    [name]=> "AuthenticationError"
    [message]=> "Token MissMatch"
)

Parameters
owner_id* string	a valid Sarv User Id
token* string	a valid token
SarvTES_APP_DOMAIN* string	a valid SarvTES 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. Sarv Developers will be notified.
AuthenticationError	Provided owner_id and token was not matched.