CentralNic Reseller Homepage
CentralNic Reseller Homepage

.kyoto

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.

Domain Registration

(API Command reference » AddDomain)
Command
command         = AddDomain
domain          = yourdomain.kyoto
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)

After a successful registration of the domain, it will be transfer locked from the registry for a period of 60 days.

Domain Modification

(API Command reference » ModifyDomain)
Command
command = ModifyDomain
domain  = yourdomain.kyoto

Domain Renewal

(API Command reference » RenewDomain)
Command
command    = RenewDomain
domain     = yourdomain.kyoto
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)
Command
COMMAND = DeleteDomain
DOMAIN = yourdomain.kyoto

Domain Transfer

(API Command reference » TransferDomain)
Command
command = TransferDomain
domain = yourdomain.kyoto
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 .kyoto 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.kyoto

Domain Restrictions

Eligible registrants are:

  • Kyoto municipalities and local governments;
  • Public and private institutions with a valid physical address in Kyoto;
  • Organizations, companies, and other businesses with a valid physical address in Kyoto; and
  • Natural persons with a valid physical address in Kyoto.

All Registrants must remain in compliance with the nexus requirements at all times. The Registry will conduct scans of registration data from time to time in order to ensure compliance with the registration requirements. Any failure of a registration to satisfy the
Nexus Requirement will result in the name being placed on a hold for an initial period of 30 days. The sponsoring Registrar will be notified of such a hold and be given the opportunity to correct any information. If the Registrant does not comply during the hold time frame, the domain name may be subject to deletion. Further details can be found in the domain name registration policy.

Supported IDN Scripts

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

ArabicAR
ChineseZH
Dutch FlemishNL
FrenchFR
GermanDE
JapaneseJA
KoreanKO
PolishPL
PortuguesePO
PortuguesePT
RussianRU
SpanishES
TurkishTR

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.

We reallydomains
-