Revision as of 17:24, 11 March 2014 (view source) WikiAdmin (Talk | contribs) ← Older edit		Latest revision as of 18:09, 15 October 2024 (view source) Timo (Talk | contribs) (→‎Authorization Code)
(16 intermediate revisions by 2 users not shown)
Line 10:		Line 10:
	{{#repositoryinfo:  AT-LIVE-1API | at }}		{{#repositoryinfo:  AT-LIVE-1API | at }}
	{{Sidebar}}		{{Sidebar}}
−	<div style="font-size: 200%;">'''.AT'''</div><br/>	+	<div style="font-size: 250%;">'''.AT'''</div><br/>
	.AT is the official country code Top-Level-Domain (ccTLD) of Austria. An .AT Domain is normally used by companies or private entities who are located in Austria or who have business relationships with Austria.		.AT is the official country code Top-Level-Domain (ccTLD) of Austria. An .AT Domain is normally used by companies or private entities who are located in Austria or who have business relationships with Austria.
Line 92:		Line 92:
	period = (PERIOD)		period = (PERIOD)
	transferlock = 0 | 1 | (NULL)		transferlock = 0 | 1 | (NULL)
		+	X-AT-DISCLOSE = 0 | 1
		+	X-AT-DISCLOSE-VOICE = 0 | 1
		+	X-AT-DISCLOSE-FAX = 0 | 1
		+	X-AT-DISCLOSE-EMAIL = 0 | 1
	</pre>		</pre>
		+	[https://wiki.hexonet.net/index.php/AT#tab=TLD_specific Further information can be found at TLD specific]
	=== Domain Transfer ===		=== Domain Transfer ===
	{{#var:TRANSFERSENTENCE}}		{{#var:TRANSFERSENTENCE}}
−	<br>
−	In case that you our your client does not have access to his mailbox anymore the transfer can be confirmed alternatively via fax. The fax can be downloaded direcly on the NIC.AT´s Website [http://www.nic.at/service/faxbestaetigungen/ http://www.nic.at/service/faxbestaetigungen/]
−	<b>Please fax this form directly to NIC.AT +43 662 46 69-29</b>
	{{#var:TRANSFERDOMAINCOMMAND}}		{{#var:TRANSFERDOMAINCOMMAND}}
		+	<span class="label label-important">REQUIRED</span>
		+	<pre>
		+	auth = (TEXT)
		+	</pre>
	<span class="label label-info">OPTIONAL</span>		<span class="label label-info">OPTIONAL</span>
Line 124:		Line 130:
	=== Ownerchange ===		=== Ownerchange ===
−	All contact information with the exception of registrant Name, Firstname and Organisation can be updated through the ModifyDomain command.
−	{{warnbox|Please note that the registry does not support handle updates. You have to create a new handle containing the same information for Name, Firstname and Organisation as well as the updated contact information and attach it to the domain with the ModifyDomain command.}}	+	All contact information can be updated through the ModifyDomain command.
		+
		+	{{warnbox|Please note that the registry does not support handle updates. You have to create a new handle and assign it to the domain by using the ModifyDomain command.}}
	<pre>		<pre>
	command = ModifyDomain		command = ModifyDomain
Line 135:		Line 142:
	ownercontact0 = (CONTACT)		ownercontact0 = (CONTACT)
	</pre>		</pre>
−
−
−	In order to change the owner you have to request a trade with the TradeDomain command. This can be done through our web interface or through our API:
−	<pre>
−	command = TradeDomain
−	domain = (DOMAIN)
−	</pre>
−	<span class="label label-important">REQUIRED</span>
−	<pre>
−	ownercontact0 = (CONTACT)
−	</pre>
−
−	Before a trade gets processed by the registry, a fax form is required by the registry to process a trade. Once confirmed then the trade will be processed. The fax form can be generated with our [http://www.domainform.net/form/index.php formgenerator]
	= TLD specific =		= TLD specific =
Line 161:		Line 155:
	Indicates, if the registry should delete the domain at the end of its term ("expiration") or immediately ("now"). If the parameter is not given the domain will be deleted at the end of its term.		Indicates, if the registry should delete the domain at the end of its term ("expiration") or immediately ("now"). If the parameter is not given the domain will be deleted at the end of its term.
	<br><br>		<br><br>
−	If you do not have the consent of the registrant you should set the domain renewal mode to AUTOEXPIRE. This will cause a so-called '''BILLWITHDRAW''' at the registry at the end of the term of the domain. A BILLWITHDRAW means that the registrant will become the new billing contact of the domain and will be charged directly from the registry for the renewal of his domain.	+	If you do not have the consent of the registrant you should set the domain renewal mode to AUTOEXPIRE. This will cause a '''BILLWITHDRAW''' at the registry at the end of the term of the domain. A BILLWITHDRAW means that the registrant will become the new billing contact of the domain and will be charged directly from the registry for the renewal of his domain.
		+
		+	A '''BILLWITHDRAW''' can be explicitly triggered by executing:
		+
		+	<pre>
		+	COMMAND = PUSHDOMAIN
		+	DOMAIN = YOURDOMAIN.AT
		+	TARGET = REGISTRY
		+	</pre>
		+
	<br>		<br>
	As the .AT registry handles domain-deletions very strict, we highly recommend to save a written confirmation of your client for domain-transactions.		As the .AT registry handles domain-deletions very strict, we highly recommend to save a written confirmation of your client for domain-transactions.
	'''In case that you have to delete domains immediately, e.g. in case of fraud, the only way is to delete the domain with the API [[API:DeleteDomain | DeleteDomain]] command and setting the parameter X-AT-SCHEDULEDATE to "now".'''		'''In case that you have to delete domains immediately, e.g. in case of fraud, the only way is to delete the domain with the API [[API:DeleteDomain | DeleteDomain]] command and setting the parameter X-AT-SCHEDULEDATE to "now".'''
	<br><br>		<br><br>
−	{{Warnbox|Please note that you're only allowed to delete .AT domains directly if you have the signed authorization of the registrant. The cancellation-form is available for download here: http://www.nic.at/service/faxbestaetigungen/}}
−	=== Restore ===	+	=== Authorization Code ===
−	'''Restore are possible''' if the domain was deleted explicitly with the DeleteDomain command or set to '''"AUTODELETE"'''.	+	If you want to transfer a .AT domain name without an authcode from the losing registrar, a "token" needs to be requested using the RequestDomainAuthInfo command:
−		+	<pre>
−	'''Restores are not possible''' if the domain was set to '''"AUTOEXPIRE"''' or was '''pushed''' back to the registry with the PushDomain command. In order to get your domain back, please request a transfer via API or Controlpanel. Please note that as soon as you have requested a transfer, NIC.AT will send out a confirmation email to the domain-owner to confirm the transfer.	+	command = RequestDomainAuthInfo
		+	domain = (DOMAIN)
		+	</pre>
		+
		+	The special transfer token will be sent to the registrant email address by NIC.AT. In a second step, the TransferDomain command can be used with the "token" as authcode.
		+
		+	The token will '''''be valid for 21 days''''' once requested.
		+
		+	=== Registration ===
		+	By default '''privacy protection''' is disabled. You can disclose the information with using the following extension:
		+
		+	<pre>
		+	X-AT-DISCLOSE = 0 | 1
		+	X-AT-DISCLOSE-VOICE = 0 | 1
		+	X-AT-DISCLOSE-FAX = 0 | 1
		+	X-AT-DISCLOSE-EMAIL = 0 | 1
		+	</pre>
		+	It is not possible to mix enable/disable flags in one command.
	= Addons =		= Addons =

---

Latest revision as of 18:09, 15 October 2024

.AT is the official country code Top-Level-Domain (ccTLD) of Austria. An .AT Domain is normally used by companies or private entities who are located in Austria or who have business relationships with Austria.

Introduced	1988
Country	Austria
Registry	Nic AT
IDN Capable	Yes
Webpage	Register .AC

Contents 1 Registry 2 Periods 3 API 3.1 Domain Registration 3.2 Domain Transfer 3.3 Delete Domain 3.4 Restore Domain 3.5 Ownerchange 4 TLD specific 4.1 Special deletion information 4.2 Authorization Code 4.3 Registration 5 Addons 6 RegistrarOC 6.1 Restore Process

[edit] Registry

TLD	.at
Allowed TLDs	.at, .or.at, .co.at
Registry	nic.at
Dispute Policy	Rules
Registrar	1api GmbH
WHOIS-Server	whois.nic.at
WHOIS-Update	24 hours
Min. Characters	1
Max. Characters	63
Character Set	Letters and numbers Hyphens ("-"), however not at the beginning or directly in front of the TLD IDN: allowed
Limitations	Registrant Contacts: Required: 1 / Maximum: 1 Admin Contacts: Required: 0 / Maximum: 1 Tech Contacts: Required: 1 / Maximum: 2 Billing Contacts: Required: 0 / Maximum: 1
{{{Possible Extensions}}}
IDN capable	Yes
Restore capable	Real-Time
Handle Updates	Supported (partially)
Registration System	Real-Time
Allowed number of NS	2 to 8
Registry Nameservercheck	No
Host IP-Addresses Type	IPv4 / IPv6
Hosts managed as	Attribute
Root Nameserver Update	4 times a day
SEC DNS Interface	DS data interface
Transferclass	Pull
Transfer Periods	0Y
Transfer Authcode required	Yes
Transfer Real-Time	Yes
Transfer Lock	No
Owner Change by	Update
Trade Real-Time	No
Transfer included	No
Trade ACK by	Both
Trade NACK by	Both

[edit] Periods

{{{Possible Extensions}}}
Registration Periods	1 year
Add Grace Period	0 days
Accounting Period	-7 days
Finalization Period	-2 days
Failure Period	-2 days
Payment Period	-61 days
Deletion Restorable Period	60 days
Deletion Hold Period	59 days
Explicit Renewals	No
Renewal Periods	1 year

[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)
period = (PERIOD)
transferlock = 0 | 1 | (NULL)
X-AT-DISCLOSE = 0 | 1
X-AT-DISCLOSE-VOICE = 0 | 1
X-AT-DISCLOSE-FAX = 0 | 1
X-AT-DISCLOSE-EMAIL = 0 | 1

Further information can be found at TLD specific

[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

auth = (TEXT)

OPTIONAL

period = (PERIOD)
transferlock = 0 | 1 | (NULL)
action = REQUEST | APPROVE | DENY | CANCEL | USERTRANSFER

[edit] Delete Domain

Domains can be deleted with the API DeleteDomain command.
There is a Deletion Restorable Period of 60 days and a following Deletion Hold Period of 59 days.

command = DeleteDomain
domain = (DOMAIN)

Further information can be found at TLD specific

[edit] Restore Domain

Restores can be processed in realtime. A restore is possible within 60 days upon deletion. Please use the command RestoreDomain.

command = RestoreDomain
domain = (DOMAIN)

OPTIONAL

subuser = (TEXT)
renewalmode = (NULL) | (TEXT)

Further information can be found at TLD specific

[edit] Ownerchange

All contact information can be updated through the ModifyDomain command.

command = ModifyDomain
domain = (domain)

REQUIRED

ownercontact0 = (CONTACT)

[edit] TLD specific

[edit] Special deletion information

You can choose, if the registry should delete the domain immediately or at the end of its term with the following extension:

X-AT-SCHEDULEDATE = expiration | now 

Optional:
Indicates, if the registry should delete the domain at the end of its term ("expiration") or immediately ("now"). If the parameter is not given the domain will be deleted at the end of its term.

If you do not have the consent of the registrant you should set the domain renewal mode to AUTOEXPIRE. This will cause a BILLWITHDRAW at the registry at the end of the term of the domain. A BILLWITHDRAW means that the registrant will become the new billing contact of the domain and will be charged directly from the registry for the renewal of his domain.

A BILLWITHDRAW can be explicitly triggered by executing:

COMMAND = PUSHDOMAIN
DOMAIN = YOURDOMAIN.AT
TARGET = REGISTRY

As the .AT registry handles domain-deletions very strict, we highly recommend to save a written confirmation of your client for domain-transactions. In case that you have to delete domains immediately, e.g. in case of fraud, the only way is to delete the domain with the API DeleteDomain command and setting the parameter X-AT-SCHEDULEDATE to "now".

[edit] Authorization Code

If you want to transfer a .AT domain name without an authcode from the losing registrar, a "token" needs to be requested using the RequestDomainAuthInfo command:

command = RequestDomainAuthInfo
domain = (DOMAIN)

The special transfer token will be sent to the registrant email address by NIC.AT. In a second step, the TransferDomain command can be used with the "token" as authcode.

The token will be valid for 21 days once requested.

[edit] Registration

By default privacy protection is disabled. You can disclose the information with using the following extension:

X-AT-DISCLOSE = 0 | 1
X-AT-DISCLOSE-VOICE = 0 | 1
X-AT-DISCLOSE-FAX = 0 | 1
X-AT-DISCLOSE-EMAIL = 0 | 1 

It is not possible to mix enable/disable flags in one command.

[edit] Addons

[edit] RegistrarOC

Restore Process

To restore a domain as a RegistrarOC customer, you simply have to execute the RestoreDomain command. HEXONET directly forwards the restore request to the registry, which performs the restore in real-time. As soon as the restore is complete, the domain will get assigned to your account with the original domain data.