.台灣

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--kpry57d
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-TW-COMPANY-NUMBER = (TEXT)

X-TW-COMPANY-NUMBER only required if the owner is a company/organisation. For registrations with natural persons as owner, the extension is not mandatory.

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.xn--kpry57d

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.xn--kpry57d

Domain Transfer

(API Command reference » TransferDomain)

Command

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

Transfer Notes

• .xn—kpry57d domain transfer must be initiated with a valid “Authorization Code” that can be obtained from the current registrar through the owner or Admin-C of the domain.
• Ensure that the respective domain does not have a lock-status (REGISTRAR-LOCK or HOLD).
• Initiate the transfer on time and not just shortly before the domain expires. The domain must be older than 60 days or the last transfer must be more than 60 days ago, otherwise the transfer will be denied.
• The transfer request is processed following a FOA handling: A notification e-mail will be sent to the registrant who must confirm the requested transfer. The transfer will only be processed after confirmation. Otherwise the transfer request expires.

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.xn--kpry57d

Domain Extensions

X-TW-COMPANY-NUMBER	VAT number required, if the owner is a company/organisation

Domain Restrictions

Registrants of .xn—kpry57d domains must comply to the General Terms and Conditions of .tw domains:

• Supervision and Guidance Regulation for Internet Protocol (IP) Address and Domain Name Registration and Management Services currently at http://www.twnic.net.tw/file/ip0320.htm
• Guidelines for Administration of Domain Name Registration, currently at https://www.twnic.net.tw/en_dnservice_giuldlines.php
• Domain Name Registration Policies and Regulations, currently at https://www.twnic.net.tw/en_dnservice_guidelines_regulation.php
• TWNIC Domain Name Dispute Resolution Policy, currently at https://www.twnic.net.tw/en_dnservice_policy-1.php
• Rules for TWNIC Domain Name Dispute Resolution Policy, currently at https://www.twnic.net.tw/en_dnservice_policy-2.php
• A registration for .ORG.TW domains is now only possible for non profit organizations located in Taiwan. The only exception is for foreign non-profit organizations that provide supporting documentation of their non-profit status under the competent laws of their jurisdiction and if the Domain Name Committee of TWNIC approves such documentation. You can download the necessary document for an application of a .ORG.TW domain name here: Application_for_ORG.TW.pdf
• The registrant for a .COM.TW domain name must be a corporation registered under the Company Law or a business registered under the Commercial Entity Registration Law, or a foreign corporation registered under competent national or state laws. Also the registrant should provide true, complete and accurate information. The registrant will be asked to submit documentations for review when necessary.

IDN Information

• Traditional Chinese characters only beneath .TW and not for Third-Level .TW domains.

Supported IDN Scripts

The following IDN scripts are supported by .xn—kpry57d.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.

Chinese	ZH
English	EN
French	FR
German	DE
Japanese	JA
Korean	KO
Thai	TH

Get more information of “IDN tables”, which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.