From HEXONET Wiki
(→Domain Registration) |
(→Registering Reserved Second Level Domains) |
||
| (22 intermediate revisions by 2 users not shown) | |||
| Line 4: | Line 4: | ||
| introduced = 1987 | | introduced = 1987 | ||
| country = New Zealand | | country = New Zealand | ||
| − | | registry = | + | | registry = Internet New Zealand Incorporated (InternetNZ) |
| idn capable = Yes | | idn capable = Yes | ||
| webpage = [https://www.hexonet.net/domain-name/nz Register .NZ] | | webpage = [https://www.hexonet.net/domain-name/nz Register .NZ] | ||
}} | }} | ||
| − | {{#repositoryinfo: | + | {{#repositoryinfo: NZEPP2-LIVE-1API | co.nz }} |
{{Sidebar}} | {{Sidebar}} | ||
<div style="font-size: 250%;">'''.NZ'''</div><br/> | <div style="font-size: 250%;">'''.NZ'''</div><br/> | ||
| Line 15: | Line 15: | ||
__TOC__ | __TOC__ | ||
| − | + | = NOTE = | |
<div class="alerthexonet alerthexonet-error">From '''12.04.2017''' all .NZ domains which will expire till '''15.04.2017''' or where expiration date lies in past, we will only accept transfer requests where "'''PERIOD=1'''" or "'''PERIOD=1Y'''" is explicitly stated. Requests where "'''PERIOD=0'''" or "'''No Period'''" is stated will not be accepted and result in an error.</div> | <div class="alerthexonet alerthexonet-error">From '''12.04.2017''' all .NZ domains which will expire till '''15.04.2017''' or where expiration date lies in past, we will only accept transfer requests where "'''PERIOD=1'''" or "'''PERIOD=1Y'''" is explicitly stated. Requests where "'''PERIOD=0'''" or "'''No Period'''" is stated will not be accepted and result in an error.</div> | ||
| − | + | = Registry = | |
{{Summarybox | {{Summarybox | ||
| TLD={{#IfEmpty: {{#var:TLD}} | {{#var:TLD}} | - }} | | TLD={{#IfEmpty: {{#var:TLD}} | {{#var:TLD}} | - }} | ||
| Line 61: | Line 61: | ||
}} | }} | ||
| − | + | = Periods = | |
{{Summarybox | {{Summarybox | ||
| Registration Period={{#var:ZONEREGISTRATIONPERIODS}} | | Registration Period={{#var:ZONEREGISTRATIONPERIODS}} | ||
| Line 77: | Line 77: | ||
= API = | = API = | ||
| − | + | == Domain Registration == | |
{{#var:REGISTRATIONSENTENCE}} | {{#var:REGISTRATIONSENTENCE}} | ||
{{#var:ADDDOMAINCOMMAND}} | {{#var:ADDDOMAINCOMMAND}} | ||
| Line 94: | Line 94: | ||
transferlock = 0 | 1 | <NULL> | transferlock = 0 | 1 | <NULL> | ||
subuser = <TEXT> | <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) | |
</pre> | </pre> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | == Domain Transfer == | |
{{#var:TRANSFERSENTENCE}} | {{#var:TRANSFERSENTENCE}} | ||
{{#var:TRANSFERDOMAINCOMMAND}} | {{#var:TRANSFERDOMAINCOMMAND}} | ||
| Line 122: | Line 118: | ||
</pre> | </pre> | ||
| − | + | == Delete Domain == | |
{{#var:DELETESENTENCE}} | {{#var:DELETESENTENCE}} | ||
{{#var:DELETEDOMAINCOMMAND}} | {{#var:DELETEDOMAINCOMMAND}} | ||
| Line 131: | Line 127: | ||
| − | + | == Restore Domain == | |
{{#var:RESTOREPOLICYSENTENCE}} | {{#var:RESTOREPOLICYSENTENCE}} | ||
{{#var:RESTOREDOMAINCOMMAND}} | {{#var:RESTOREDOMAINCOMMAND}} | ||
| Line 146: | Line 142: | ||
| − | + | == Ownerchange == | |
{{#var:TRADESENTENCE}} | {{#var:TRADESENTENCE}} | ||
| − | + | = TLD specific = | |
| − | == | + | == Individual Registrant Privacy Option (IRPO) == |
| − | + | {{Warnbox| | |
| + | <p>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.</p> | ||
| − | + | <p>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.</p> | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | The | + | <p>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.</p> |
| − | + | ||
| − | + | <p>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.</p> | |
| + | }} | ||
| − | |||
| − | == | + | == Second Level Domain Registration Documents == |
| + | * EPP Guide: [[Media:HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf|HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf]] | ||
| − | + | == Generating an Authorisation Code == | |
| + | <pre> | ||
| + | COMMAND = ModifyDomain | ||
| + | GENERATERANDOMAUTH = 1 | ||
| + | DOMAIN = <domain> | ||
| + | </pre> | ||
| − | The transfer may then be requested in the Control Panel or with the following API command using the new | + | === Expiring Authorisation 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: | ||
<pre> | <pre> | ||
| Line 182: | Line 188: | ||
</pre> | </pre> | ||
| − | == | + | The resolved name can only be registered using details that match the registrant details used for the qualifying 3rd level domain name. Approval will not be given for registration under other details. |
| + | |||
| + | == 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. | ||
| + | <pre> | ||
| + | command=modifycontact | ||
| + | contact=<CONTACT-HANDLE> | ||
| + | X-NZ-DISCLOSE=1 | ||
| + | X-NZ-DISCLOSE-ELEMENTS=ADDR VOICE FAX EMAIL VAT IDENT NOTIFYEMAIL | ||
| + | </pre> | ||
| + | |||
| + | = Addons = | ||
{{#var:DOMAINADDONTABLE}} | {{#var:DOMAINADDONTABLE}} | ||
| − | + | = RegistrarOC = | |
{{#var:REGISTRAROCSENTENCE}} | {{#var:REGISTRAROCSENTENCE}} | ||
{{#var:CATEGORY}} | {{#var:CATEGORY}} | ||
Latest revision as of 13:59, 1 March 2023
 |
|
| Introduced | 1987 |
|---|---|
| Country | New Zealand |
| Registry | Internet New Zealand Incorporated (InternetNZ) |
| IDN Capable | Yes |
| Webpage | Register .NZ |
Contents |
[edit] NOTE
[edit] Registry
| TLD |
- |
| Allowed TLDs |
- |
| Registry | |
| Dispute Policy | |
| Registrar |
1api GmbH |
| WHOIS-Server |
whois.srs.net.nz |
| WHOIS-Update |
Real-Time |
| Min. Characters |
1 |
| Max. Characters |
63 |
| Character Set |
|
| Limitations |
|
| IDN capable |
Yes |
| Restore capable |
Real-Time |
| Handle Updates |
Supported |
| Registration System |
Real-Time |
| Allowed number of NS |
0 to 10 |
| Registry Nameservercheck |
No |
| Host IP-Addresses Type |
IPv4 / IPv6 |
| Hosts managed as |
Object |
| Root Nameserver Update |
hourly |
| SEC DNS Interface |
DS data interface |
| Transferclass |
Pull |
| Transfer Periods |
0Y,1Y |
| Transfer Authcode required |
Yes |
| Transfer Real-Time |
Yes |
| Transfer Lock |
Yes |
| Transfer Confirmation (Request / Approve) |
- / - |
| Owner Change by |
Update |
[edit] Periods
| Registration Periods |
1-10 years |
| Add Grace Period |
0 days |
| Accounting Period |
-1 day |
| Finalization Period |
44 days |
| Failure Period |
44 days |
| Payment Period |
-61 days |
| Deletion Restorable Period |
90 days |
| Deletion Hold Period |
2 days |
| Explicit Renewals |
Yes |
| Renewal Periods |
1-9 years |
[edit] API
[edit] Domain Registration
Domains can be registered in Real-Time 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)
[edit] Domain Transfer
The transfer has to be initiated by the gaining registrar and can be requested with the API TransferDomain command.
A valid Authorization Code must be provided to initiate a transfer successfully. You may obtain the authorization code from the losing registrar.
Domain transfers are processed in Real-Time.
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>
[edit] Delete Domain
Domains can be deleted with the API DeleteDomain command.
There is a Deletion Restorable Period of 90 days and a following Deletion Hold Period of 2 days.
command = DeleteDomain domain = (DOMAIN)
REQUIRED
n/a
[edit] Restore Domain
Restores can be processed in realtime. A restore is possible within 90 days upon deletion. Please use the command RestoreDomain.
command = RestoreDomain domain = (DOMAIN)
REQUIRED
n/a
OPTIONAL
renewalmode = <NULL> | <TEXT> subuser = <TEXT>
[edit] Ownerchange
An Ownerchange is free of charge and can be done with the API ModifyDomain command.
[edit] TLD specific
[edit] 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.
[edit] Second Level Domain Registration Documents
* EPP Guide: HEXONET_EPP_Guide_to_the_New_Procedures_for_NZ_Domains_v1.00.pdf
[edit] Generating an Authorisation Code
COMMAND = ModifyDomain GENERATERANDOMAUTH = 1 DOMAIN = <domain>
[edit] Expiring Authorisation 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.
[edit] 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
The resolved name can only be registered using details that match the registrant details used for the qualifying 3rd level domain name. Approval will not be given for registration under other details.
[edit] 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-NZ-DISCLOSE=1 X-NZ-DISCLOSE-ELEMENTS=ADDR VOICE FAX EMAIL VAT IDENT NOTIFYEMAIL
