From HEXONET Wiki
(→Registering Reserved Second Level Domains) |
(→Generating an Authorisation Code) |
||
Line 168: | Line 168: | ||
# go to Dashboard > ObjectLog and enter the domain. | # go to Dashboard > ObjectLog and enter the domain. | ||
− | The latest response will deliver the NEW | + | The latest response will deliver the NEW Auth Code. |
− | While using the API, after unlocking the domain, you will receive an Event from our system with the new | + | While using the API, after unlocking the domain, you will receive an Event from our system with the new Auth code. |
'''Note''': The Auth-Code must be 16 characters in length and consist only of alphanumeric characters, i.e. lowercase a to z, uppercase A to Z, numerals 0 to 9 or the hyphen (-) | '''Note''': The Auth-Code must be 16 characters in length and consist only of alphanumeric characters, i.e. lowercase a to z, uppercase A to Z, numerals 0 to 9 or the hyphen (-) |
Revision as of 11:35, 23 November 2022
Introduced | 1987 |
---|---|
Country | New Zealand |
Registry | Internet New Zealand Incorporated (InternetNZ) |
IDN Capable | Yes |
Webpage | Register .NZ |
Contents |
NOTE
Registry
TLD |
- |
Allowed TLDs |
- |
Registry |
- |
Dispute Policy |
- |
Limitations |
|
Allowed number of NS |
to |
Periods
API
Domain Registration
Domains can be registered with the API AddDomain command.
command = AddDomain domain = (DOMAIN)
REQUIRED
ownercontact0 = (CONTACT) admincontact0 = (CONTACT) techcontact0 = (CONTACT) billingcontact0 = (CONTACT) nameserver0 = (NAMESERVER) nameserver1 = (NAMESERVER)
OPTIONAL
auth = <TEXT> | <NULL> transferlock = 0 | 1 | <NULL> subuser = <TEXT> | <NULL> X-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) X-REGISTRANT-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) X-ADMIN-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option) X-TECH-DISCLOSE = 0 | 1 (0 = select privacy option, 1 = turn off privacy option)
Additional information: Individual Registrant Privacy Option (IRPO)
The optional X-DISCLOSE flags allow a registrant to use the Individual Registrant Privacy Option (IRPO). Choosing to enable the IRPO will hide the phone number and address information for the domain contact(s) in WHOIS search results.
The X-DISCLOSE parameter applies privacy to all contacts, the X-REGISTRANT-DISCLOSE parameter applies privacy to registrant contact only, the X-ADMIN-DISCLOSE parameter applies privacy to admin contact only, and the X-TECH-DISCLOSE parameter applies privacy to tech contact only.
The registrar contact is not subject to WHOIS privacy. If the registrar contact is similar to any of the above contacts, then there should be two contact handles, one which is applicable for WHOIS privacy and one that not subject to WHOIS privacy.
By enabling this feature, a .NZ domain registrant guarantees that they are an individual registrant and not using their .NZ domain(s) for significant trade.
Domain Transfer
There is a special procedure to handle a domain transfer. Please contact our Support-Team if you should need further information.
command = TransferDomain domain = (DOMAIN)
REQUIRED
action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER auth = <TEXT>
OPTIONAL
order = CREATE | REPLACE | UPDATE subuser = <TEXT> | <NULL> period = <PERIOD> transferlock = 0 | 1 | <NULL>
Delete Domain
Domains can be deleted with the API DeleteDomain command.
There is no Deletion Restorable Period.
command = DeleteDomain domain = (DOMAIN)
REQUIRED
n/a
Restore Domain
command = RestoreDomain domain = (DOMAIN)
REQUIRED
n/a
OPTIONAL
renewalmode = <NULL> | <TEXT> subuser = <TEXT>
Ownerchange
TLD specific
Second Level Domain Registration Documents
* EPP Guide: HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf
Generating an Authorisation Code
In order to set an Auth code for your domain, please proceed as follows in the HEXONET Control Panel:
- Unlock the domain (remove the transfer lock)
- Wait a few minutes
- go to Dashboard > ObjectLog and enter the domain.
The latest response will deliver the NEW Auth Code. While using the API, after unlocking the domain, you will receive an Event from our system with the new Auth code.
Note: The Auth-Code must be 16 characters in length and consist only of alphanumeric characters, i.e. lowercase a to z, uppercase A to Z, numerals 0 to 9 or the hyphen (-)
Expiring Authorization Codes
Please note that Auth Codes may only be obtained from the current registrar of a domain name, and that they expire after 30 days.
Registering Reserved Second Level Domains
The .NZ Registry offers Registrants, who already own a .CO.NZ (NET.NZ / ORG.NZ ) domain the possibility to register the name-pendant under .NZ. Requirement is, that the .CO.NZ (NET.NZ / ORG.NZ ) is registered in HEXONET. If this is the case, you should submit a "transfer-request" for the corresponding .NZ domain, by providing the Auth code of the existing .CO.NZ (NET.NZ / ORG.NZ ) - Domain. If necessary, see above on how to obtain an Auth code for an existing domain.
The transfer may then be requested in the Control Panel or with the following API command using the new Auth code (AUTH) of the third-level domain:
COMMAND = Transferdomain DOMAIN = example.nz AUTH = ABCDE1234 PERIOD = 1 EOF
Modify Contact
Specify which dedicated contact details should be affected by the DISCLOSE parameter setting. If not stated the DISCLOSE parameter affects all possible contact details. Multiple values are possible and have to be separated by a blank space.
command=modifycontact contact=<CONTACT-HANDLE> X-CZ-DISCLOSE=1 X-CZ-DISCLOSE-ELEMENTS=ADDR VOICE FAX EMAIL VAT IDENT NOTIFYEMAIL