.广东

API commandsExtensionsRestrictionsIDN

API Commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

Exception

command         = AddDomain
domain          = yourdomain.xn--xhq521b
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-CNNIC-OWNER-ID-CODE = (TEXT)
X-CNNIC-OWNER-ID-TYPE = YYZZ|ZZJGDMZ|SFZ|JGZ|HZ|QT
X-CNNIC-ADMIN-ID-CODE = (TEXT)
X-CNNIC-ADMIN-ID-TYPE = YYZZ|ZZJGDMZ|SFZ|JGZ|HZ|QT
X-CNNIC-TECH-ID-CODE = (TEXT)
X-CNNIC-TECH-ID-TYPE = YYZZ|ZZJGDMZ|SFZ|JGZ|HZ|QT
X-CNNIC-BILLING-ID-CODE = (TEXT)
X-CNNIC-BILLING-ID-TYPE = YYZZ|ZZJGDMZ|SFZ|JGZ|HZ|QT

• Furthermore a copy of the respective document must be sent via e-mail ([email protected]) to us. Please pay attention to the correct subject line of the e-mail: Register [domain name] documents, e.g.”Register example.xn—xhq521b documents”. Please provide the document in one of the following formats: .jpg, .png, .gif or .jpeg (document size max. 1 MB).
• After a successful registration of the domain, it will be transfer locked from the registry for a period of 60 days.

.CN: No Special Characters in Registrant Names

The Chinese Registry CNNIC has been enforcing the Real-Name Verification (RNV) regulation for .CN and .中国 (.xn—fiqs8s) domains since last year.

The RNV process requires a real name of an individual person to be provided in the Owner Contact. In addition, a proof of identification (e.g. passport, ID card) is needed to register / transfer / trade a .CN or .中国 domain.

The following problem occurs: If the registrant is foreign (so not Chinese) and the name contains special non-English characters, CNNIC cannot process auditing the passport and registration / transfer / trade cannot be completed.

The solution is to provide a registrant name without special characters. If the registrant is a company, the domain may be registered to another person of the company who does not have special characters in the name and is willing to submit a verification document to CNNIC.

Please note: We refer here to the full name as it appears on the verification document such as the passport.

Examples for special characters that lead to problems:

German umlauts such as ä, ü, ö;

Spanisch / French letters with accents such as é

and other characters not found in the English language.

If you have any further questions, please contact our Support Team.

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.xn--xhq521b

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.xn--xhq521b
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.xn--xhq521b

Domain Transfer

(API Command reference » TransferDomain)

Command

command = TransferDomain
domain = yourdomain.xn--xhq521b
action = REQUEST
auth = (TEXT)

Transfer Procedure

• The transfer is submitted to the registry and the losing registrar is automatically notified by them.
• The losing registrar sends an email to the owner (and optionally admin) contact, informing about the transfer; this may include options to approve and/or deny the transfer. If neither explicitly approved nor denied, the transfer will be automatically finalized after 5 days.

Transfer Notes

• A .xn—xhq521b domain transfer must be initiated with a so-called authorisation code, (auth-code) which can be obtained from the current registrar through the owner/admin contact of the domain.
• Ensure that your respective domain does not have a lock-status (clientTransferProhibited and/or serverTransferProhibited). This can be seen in WHOIS.
• If the domain has a client-side transfer lock, the owner can ask the current registrar to have the lock removed.

These procedures only apply for domain transfers between registrars. For internal transfers between resellers, please consult our documentation about internal transfers/usertransfers.

Auth-Codes

The format for auth info requires a minimum length of 8 characters and a maximum length of 32 characters.

Additionally, auth info must contain at least one of each of the following three character types:

• Alphabetic characters: a-z; A-Z
• Numeric characters: 0-9
• Special characters: !;<=$%?&@[()]*^+-,’-{.|/}:~

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.xn--xhq521b

Domain Extensions

X-CNNIC-(OWNER|ADMIN|TECH|BILLING)-ID-CODE	* Identity card number or trade register number * mandatory for the owner contact, optional for other contacts
X-CNNIC-(OWNER|ADMIN|TECH|BILLING)-ID-TYPE	* Type of proof of identity * mandatory for the owner contact, optional for other contacts YYZZ License(for Chinese residents only) ZZJGDMZ Organization Code Certificate(for Chinese residents only) SFZ Identitiy card(for Chinese residents only) JGZ Certificate of officers(for Chinese military members only) HZ Passport ORG Chinese Organization Code License QT Other

Domain Restrictions

There are no restrictions for .xn—xhq521b

IDN Information

Only Chinese characters are supported for IDNs.