Aus EUserv Wiki

Version vom 09:12, 3. Sep. 2012

back to API Documentation

domain.dns_create_record

 
<?php
//includes the class library
include_once("lib/xmlrpc.inc");
$xmlrpc_internalencoding = 'UTF-8';
$host="api.test.euserv.net";
$port=443;
$username="<API_USER>";
$password="<API_USER_PASSWORD>";
$api_path="/";
$domain_id=1337;
$dns_record_subdomain="";
$dns_record_type="MX";
$dns_record_value="127.0.0.1";
$dns_record_prio =10;
$dns_record_ttl="43200";
//defines the function
function domain_dns_create_record($host,$port,$username,$password,$api_path,$domain_id,$dns_record_subdomain,
$dns_record_type,$dns_record_value,$dns_record_prio,$dns_record_ttl)
{
//creates the serverurl
$serverurl = 'https://'.$host.':'.$port.'/'.$api_path;
//----------creates the message which will be send to the server----------
//creates the request for the XML-RPC Server
$request = new xmlrpcmsg('domain.dns_create_record');
//adds parameters to the request
$request->addParam
(
//creates a value of type struct which contains an array with the username and password
new xmlrpcval
(
array
(
//creates a value of type string which contains the "$username"
'login' => new xmlrpcval($username, 'string'),
//creates a value of type string which contains the "$password"
'password' => new xmlrpcval($password, 'string'),
//creates a value of type string which contains the "$srv_id"
'domain_id' => new xmlrpcval($domain_id),
//creates a value of type string which contains the "$srv_id"
'dns_record_subdomain' => new xmlrpcval($dns_record_subdomain),
//creates a value of type string which contains the "$srv_id"
'dns_record_type' => new xmlrpcval($dns_record_type),
//creates a value of type string which contains the "$srv_id"
'dns_record_value' => new xmlrpcval($dns_record_value),
//creates a value of type string which contains the "$srv_id"
'dns_record_prio' => new xmlrpcval($dns_record_prio),
//creates a value of type string which contains the "$srv_id"
'dns_record_ttl' => new xmlrpcval($dns_record_ttl),
)
,'struct'
)
);
//----------creates the XML-RPC client which represent a client of an XML-RPC server----------
//creates the client
$client = new xmlrpc_client($serverurl);
//disable SSL Keycheck
$client->setSSLVerifyPeer(0);
//----------sends the request to the server and gets the response----------
//sends the request via https and writes it into $response. timeout is set to 0
$response = $client->send($request,0,'https');
//generates a storable representation of $response and writes it into $result_xml
//echo $response->serialize();
//checks the response. if the method "faultCode" returns zero, the response was succesfull
if (0==$response->faultCode())
{
//returns the value sent by the server
$value = $response->value();
//returns the actual PHP-language value of "value"
$result_obj = $value->scalarval();
//destroys "value"
unset($value);
}
else
{
//returns the faultCode and the faultString
return $error = array ( 'faultCode' => $response->faultCode(), 'faultString' => $response->faultString());
}
//destroys "client"
unset($client);
//destroys "response"
unset($response);
//----------reads the result_obj----------
//if result_obj is set then it returns the actual PHP-language value of "result_obj"
if (isset($result_obj['status']))
{
$value['status'] = $result_obj['status']->scalarval();
}
if (isset($result_obj['dns_record_id']))
{
$value['dns_record_id'] = $result_obj['dns_record_id']->scalarval();
}
return $value;
}
//calls the function
$result = domain_dns_create_record($host,$port,$username,$password,$api_path,$domain_id,$dns_record_subdomain,
$dns_record_type,$dns_record_value,$dns_record_prio,$dns_record_ttl);
if(0==$result['faultCode'])
{
echo "Status: ".$result['status']."<br><br>".$result['dns_record_id'];
}
else
{
echo "faultCode: ".$result['faultCode']." faultString: ".$result['faultString'];
}
?>