DomainCreate
From NETIM
(Difference between revisions)
m (Text replace - "API Version 1 (Recommended)" to "API Version 1 (Deprecated)") |
|||
(9 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
[[Category:Functions]] | [[Category:Functions]] | ||
+ | |||
+ | |||
+ | <tabs> | ||
+ | <tab name="API Version 2 (Recommended)"> | ||
+ | |||
+ | {| class="wikitable" style="width: 200px;" | ||
+ | ! Release | ||
+ | ! Runtim | ||
+ | |- | ||
+ | |API >= 2.0|| Synchronous | ||
+ | |} | ||
+ | |||
+ | '''Description''' | ||
+ | |||
+ | Requests a new domain registration | ||
+ | |||
+ | [[StructOperationResponse]] domainCreate(string idSession, string domain, string idOwner, string idAdmin, string idTech, string idBilling, string ns1, string ns2, string ns3, string ns4, string ns5, int duration [, in t templateDNS] ) | ||
+ | |||
+ | |||
+ | '''Parameters''' | ||
+ | {| class="wikitable" style="width: 800px;" | ||
+ | ! Format | ||
+ | ! Variable | ||
+ | ! Description | ||
+ | ! Notes | ||
+ | |- | ||
+ | |style="width: 100px;" | string (32)|| style="width: 100px;" | idSession || style="width: 200px;" | Session ID || style="width: 400px;" | | ||
+ | |- | ||
+ | |string (255)|| domain || Domain name to be registered || | ||
+ | |- | ||
+ | |string (12)|| idOwner || ID of the owner contact || ''with "isOwner=1"'' | ||
+ | |- | ||
+ | |string (12)|| idAdmin || ID of the administrative contact || ''with "isOwner=0"'' | ||
+ | |- | ||
+ | |string (12)|| idTech || ID of the technical contact || ''with "isOwner=0"'' | ||
+ | |- | ||
+ | |string (12)|| idBilling || ID of the billing contact || ''with "isOwner=0"'' | ||
+ | |- | ||
+ | |string (255)|| ns1 || Name server DNS 1 || | ||
+ | |- | ||
+ | |string (255)|| ns2 || Name server DNS 2 || | ||
+ | |- | ||
+ | |string (255)|| ns3 || Name server DNS 3 || | ||
+ | |- | ||
+ | |string (255)|| ns4 || Name server DNS 4 || | ||
+ | |- | ||
+ | |string (255)|| ns5 || Name server DNS 5 || | ||
+ | |- | ||
+ | |int ||duration || duration || ''in years'' | ||
+ | |- | ||
+ | |int ||templateDNS|| Number of a DNS template|| ''Optional'' | ||
+ | |} | ||
+ | |||
+ | |||
+ | '''Return''' | ||
+ | |||
+ | A structure [[StructOperationResponse]] | ||
+ | |||
+ | |||
+ | '''Notes''' | ||
+ | |||
+ | Contact IDs must exist and belong the reseller | ||
+ | According to the extension, allocation and semantic rules may apply . See [[:Category:Tld]] | ||
+ | The duration must correspond to periods allowed by the extension. See PeriodCreate in [[:Category:Tld]] | ||
+ | The templateDNS must belong to the reseller. (If provided, the template is used. If not provided, the default template defined in the reseller account is used. | ||
+ | If no default template is defined then NETIM's template is used) | ||
+ | |||
+ | == Examples == | ||
+ | |||
+ | '''PHP''' | ||
+ | <source lang="php"> | ||
+ | <?php | ||
+ | $clientSOAP = new SoapClient("http://URL.wsdl"); | ||
+ | |||
+ | try | ||
+ | { | ||
+ | $idSession = $clientSOAP->sessionOpen("XXXX", "XXXX", "EN"); | ||
+ | $StructOperationResponse = $clientSOAP->domainCreate($idSession, "netim.com", "IDOWN", "IDADM", "IDTEC", "IDBIL", "ns1.netim.com", "ns2.netim.com", "", "", "", 1); | ||
+ | |||
+ | print_r($StructOperationResponse); | ||
+ | } | ||
+ | catch(SoapFault $fault) | ||
+ | { | ||
+ | echo "Exception : " .$fault->getMessage(). "\n"; | ||
+ | } | ||
+ | |||
+ | if(isset($idSession)) | ||
+ | { | ||
+ | $clientSOAP->sessionClose($idSession); | ||
+ | } | ||
+ | ?> | ||
+ | </source > | ||
+ | |||
+ | |||
+ | </tab> | ||
+ | <tab name="API Version 1 (Deprecated)"> | ||
+ | |||
{| class="wikitable" style="width: 200px;" | {| class="wikitable" style="width: 200px;" | ||
! Release | ! Release | ||
Line 45: | Line 142: | ||
|int ||duration || duration || ''in years'' | |int ||duration || duration || ''in years'' | ||
|- | |- | ||
− | |int ||templateDNS|| Number of a DNS template|| From API 1.5 only | + | |int ||templateDNS|| Number of a DNS template|| ''From API 1.5 only'' |
|} | |} | ||
Line 59: | Line 156: | ||
According to the extension, allocation and semantic rules may apply . See [[:Category:Tld]] | According to the extension, allocation and semantic rules may apply . See [[:Category:Tld]] | ||
The duration must correspond to periods allowed by the extension. See PeriodCreate in [[:Category:Tld]] | The duration must correspond to periods allowed by the extension. See PeriodCreate in [[:Category:Tld]] | ||
− | The templateDNS must belong to the reseller. (If provided, the template is used. If not provided, the default template defined in the reseller account is used | + | The templateDNS must belong to the reseller. (If provided, the template is used. If not provided, the default template defined in the reseller account is used. |
− | If | + | If no default template is defined then NETIM's template is used) |
== Examples == | == Examples == | ||
Line 114: | Line 211: | ||
} | } | ||
</source> | </source> | ||
+ | |||
+ | |||
+ | </tab> | ||
+ | </tabs> |
Latest revision as of 15:47, 2 August 2017
Release | Runtim |
---|---|
API >= 2.0 | Synchronous |
Description
Requests a new domain registration
StructOperationResponse domainCreate(string idSession, string domain, string idOwner, string idAdmin, string idTech, string idBilling, string ns1, string ns2, string ns3, string ns4, string ns5, int duration [, in t templateDNS] )
Parameters
Format | Variable | Description | Notes |
---|---|---|---|
string (32) | idSession | Session ID | |
string (255) | domain | Domain name to be registered | |
string (12) | idOwner | ID of the owner contact | with "isOwner=1" |
string (12) | idAdmin | ID of the administrative contact | with "isOwner=0" |
string (12) | idTech | ID of the technical contact | with "isOwner=0" |
string (12) | idBilling | ID of the billing contact | with "isOwner=0" |
string (255) | ns1 | Name server DNS 1 | |
string (255) | ns2 | Name server DNS 2 | |
string (255) | ns3 | Name server DNS 3 | |
string (255) | ns4 | Name server DNS 4 | |
string (255) | ns5 | Name server DNS 5 | |
int | duration | duration | in years |
int | templateDNS | Number of a DNS template | Optional |
Return
A structure StructOperationResponse
Notes
Contact IDs must exist and belong the reseller According to the extension, allocation and semantic rules may apply . See Category:Tld The duration must correspond to periods allowed by the extension. See PeriodCreate in Category:Tld The templateDNS must belong to the reseller. (If provided, the template is used. If not provided, the default template defined in the reseller account is used. If no default template is defined then NETIM's template is used)
[edit] Examples
PHP
<?php $clientSOAP = new SoapClient("http://URL.wsdl"); try { $idSession = $clientSOAP->sessionOpen("XXXX", "XXXX", "EN"); $StructOperationResponse = $clientSOAP->domainCreate($idSession, "netim.com", "IDOWN", "IDADM", "IDTEC", "IDBIL", "ns1.netim.com", "ns2.netim.com", "", "", "", 1); print_r($StructOperationResponse); } catch(SoapFault $fault) { echo "Exception : " .$fault->getMessage(). "\n"; } if(isset($idSession)) { $clientSOAP->sessionClose($idSession); } ?>
Release | Runtim |
---|---|
API > 1.0 | Asynchronous |
Description
Requests a new domain registration
int domainCreate(string idSession, string domain, string idOwner, string idAdmin, string idTech, string idBilling, string ns1, string ns2, string ns3, string ns4, string ns5, int duration [, in t templateDNS] )
Parameters
Format | Variable | Description | Notes |
---|---|---|---|
string (32) | idSession | Session ID | |
string (255) | domain | Domain name to be registered | |
string (8) | idOwner | ID of the owner contact | with "isOwner=1" |
string (8) | idAdmin | ID of the administrative contact | with "isOwner=0" |
string (8) | idTech | ID of the technical contact | with "isOwner=0" |
string (8) | idBilling | ID of the billing contact | with "isOwner=0" |
string (255) | ns1 | Name server DNS 1 | |
string (255) | ns2 | Name server DNS 2 | |
string (255) | ns3 | Name server DNS 3 | |
string (255) | ns4 | Name server DNS 4 | |
string (255) | ns5 | Name server DNS 5 | |
int | duration | duration | in years |
int | templateDNS | Number of a DNS template | From API 1.5 only |
Return
A tracking ID
Notes
Contact IDs must exist and belong the reseller According to the extension, allocation and semantic rules may apply . See Category:Tld The duration must correspond to periods allowed by the extension. See PeriodCreate in Category:Tld The templateDNS must belong to the reseller. (If provided, the template is used. If not provided, the default template defined in the reseller account is used. If no default template is defined then NETIM's template is used)
[edit] Examples
PHP
<?php $clientSOAP = new SoapClient("http://URL.wsdl"); try { $idSession = $clientSOAP->login("XXXX", "XXXX", "EN"); $trackingID = $clientSOAP->domainCreate($idSession, "netim.com", "IDOWN", "IDADM", "IDTEC", "IDBIL", "ns1.netim.com", "ns2.netim.com", "", "", "", 1); echo($trackingID); } catch(SoapFault $fault) { echo "Exception : " .$fault->getMessage(). "\n"; } if(isset($idSession)) { $clientSOAP->logout($idSession); } ?>
JAVA
DRSServiceLocator service = new DRSServiceLocator(); String idSession; int trackingID; try { DRSPortType port = service.getDRSPort(); idSession = port.login("XXXX", "XXXX", "EN"); trackingID = port.domainCreate(idSession, "netim.com", "ID01", "ID02", "ID03", "ID04", "ns1.netim.com", "ns2.netim.com", "", "", "", 1); System.out.println(trackingID); port.logout(idSession); } catch (RemoteException re) { System.out.println(re.getMessage()); } catch (ServiceException se) { se.printStackTrace(); }