Editing CN (section)

= API =

=== Domain Registration ===
Domains can be registered in Real-Time with the API AddDomain command, a valid .CN contact at the registry is required to order .CN domains in Real-Time with the AddDomain command.

.CN domains '''require''' a validated owner contact handle for registration. Create a new registry Contact Handle with the command CheckDomainRegistration or use a already validated contact, that has already been used for another domain.

Please see below information for the [https://wiki.hexonet.net/wiki/CN#Required_Documents required documents] and verification.
 
<pre>
command = AddDomain / CheckDomainRegistration
domain  = (DOMAIN)
</pre>



<span class="label label-important">REQUIRED</span>
<pre>
ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)

X-CN-REGISTRANT-ID-NUMBER = (TEXT)
X-CN-REGISTRANT-ID-TYPE = SFZ | HZ | JGZ | ORG | YYZZ | QT

X-CN-ADMIN-ID-NUMBER = <TEXT>
X-CN-ADMIN-ID-TYPE = SFZ | HZ | JGZ | ORG | YYZZ | QT

X-CN-TECH-ID-NUMBER = <TEXT>
X-CN-TECH-ID-TYPE = SFZ | HZ | JGZ | ORG | YYZZ | QT

X-CN-BILLING-ID-NUMBER = <TEXT>
X-CN-BILLING-ID-TYPE = SFZ | HZ | JGZ | ORG | YYZZ | QT
</pre>
[[CN#X-CN-REGISTRANT-ID-TYPE_and_X-CN-REGISTRANT-ID-NUMBER|Further information can be found below]]
<br>
<span class="label label-info">OPTIONAL</span>
<pre>
auth = (TEXT) | (NULL)
period = (PERIOD)
transferlock = 0 | 1 | (NULL)
</pre>

=== Domain Transfer ===
{{#var:TRANSFERSENTENCE}}
.CN Transfers take up to 5 to 10 days
{{#var:TRANSFERDOMAINCOMMAND}}
<span class="label label-important">REQUIRED</span>
<pre>
auth = (TEXT) | (NULL)
</pre>

<span class="label label-info">OPTIONAL</span>
<pre>
period = (PERIOD)
transferlock = 0 | 1 | (NULL)
action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER
</pre>

=== Delete Domain ===
{{#var:DELETESENTENCE}}
{{#var:DELETEDOMAINCOMMAND}}

=== Restore Domain ===
{{#var:RESTOREPOLICYSENTENCE}}
{{#var:RESTOREDOMAINCOMMAND}}

<span class="label label-info">OPTIONAL</span>
<pre>
subuser = (TEXT)
renewalmode = (NULL) | (TEXT)
</pre>

=== Ownerchange ===
A Contact needs to be validated at the registry before it can be used as a registrant contact for a .cn domain. This also applies to owner changes, the new owner contact needs to be created and validated at CNNIC before it can be used as a registrant for a .cn domain.

Please use CheckDomainRegistration with a random not registered domain, the new contact handle and the respective X-Flags ,to create a new contact at CNNIC. The registry contact handle will appear in the response of the command as REPOSITORYOWNERCONTACT.

Further Info about X-Flags and required documents: https://wiki.hexonet.net/wiki/CN#TLD_specific

After a contact was validated at CNNIC, the ownerchange can be done with the API ModifyDomain command.

<pre>
command = CheckDomainRegistration / ModifyDomain
domain  = myRandomAvailableCnDomain77665544.cn / (DOMAIN)
</pre>

<pre>
REQUIRED
ownercontact0 = (CONTACT)
X-CN-REGISTRANT-ID-NUMBER = (TEXT)
X-CN-REGISTRANT-ID-TYPE = SFZ | HZ | JGZ | ORG | YYZZ | QT
</pre>