Список всех контроллеров / kzdomain / domain-create

Функция kzdomain/domain-create

Назначение:
Зарегистрировать домен .kz
Перед тем как зарегистрировать домен вам необходимо создать два контакта registrant_handle и admin_handle через метод kzdomain/contact-create. Вы можете указать один контакт как в качестве регистранта, так и администратора.
Поля запроса:
name desc
dname Имя домена.
registrant_handle Handle (id) владельца домена. (Регистрант)
admin_handle Handle (id) административного контакта домена.
nameservers Список NS-серверов. Содержит в себе списочный элемент ns
years_num Кол-во лет на которое необходимо зарегистрировать домен. От 1 до 10 лет.
srvloc Месторасположение сервера.
Состоит из элементов:
sp - область в Казахстане.
city - город.
street - адрес.
Поля ответа:
name desc
price Цена, по которой был куплен домен.
invoice_num Номер счёта в биллинговой системе.
registrant_handle Handle (id) владельца домена. (Регистрант)
registrant_contact Детальная информация о владельце домена. Описание полей доступно в методе kzdomain/contact-whois.
admin_handle Handle (id) административного контакта домена.
admin_contact Детальная информация об административном контакте. Описание полей доступно в методе kzdomain/contact-whois.
nameservers Список NS-серверов. Содержит в себе списочный элемент ns
statuses Список установленных статусов на домене. Содерит в себе списочный элемент status
expire Дата окончания делегирования домена.
Состоит из элементов:
utc - дата в формате RFC3339, время по гринвичу.
unix - время в формате unix-time.
create Информация о создании домена.
Состоит из элементов:
id - имя регистратора, который производил операцию.
utc - дата в формате RFC3339, время по гринвичу.
unix - время в формате unix-time.
update Информация об изменении домена.
Состоит из элементов:
id - имя регистратора, который производил операцию.
utc - дата в формате RFC3339, время по гринвичу.
unix - время в формате unix-time.
Элемент может быть пустым, если операция по изменению ни разу не производилась.
transfer Информация о последнем трансфере.
Состоит из элементов:
utc - дата в формате RFC3339, время по гринвичу.
unix - время в формате unix-time.
Элемент может быть пустым, если операция по трансферу ни разу не производилась.
srvloc Месторасположение сервера.
Состоит из элементов:
sp - область в Казахстане.
city - город.
street - адрес.
Пример:
Запрос:
GET JSON XML
https://api.ps.kz/kzdomain/domain-create?username=test&password=test
&input_format=http&output_format=json
&dname=test-name.kz
&registrant_handle=PS-KZ-000-000001
&admin_handle=PS-KZ-000-000001
&nameservers%5Bns%5D%5B0%5D=ns.ps.kz
&nameservers%5Bns%5D%5B1%5D=ns1.ps.kz
&years_num=1
&srvloc%5Bsp%5D=Almaty
&srvloc%5Bcity%5D=Almaty
&srvloc%5Bstreet%5D=pl.+Respubliki%2C+15

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array 
{
  "result" : "success",
  "answer" : {
    "price" : "1750",
    "invoice_num" : "5092",
    "dname" : "old.ps.kz",
    "registrar" : "ICPS",
    "registrant_handle" : "PS-KZ-000-000001",
    "registrant_contact" : {
      "handle" : "PS-KZ-000-000001",
      "name" : "Regmaster",
      "org" : "TOO \"Internet-kompaniya PS\"",
      "street" : "ploschad' Respubliki 15, office 121, 124",
      "city" : "Almaty",
      "sp" : "Almaty",
      "pc" : "050013",
      "cc" : "KZ",
      "voice" : "7-727-2954448",
      "voiceext" : "",
      "fax" : "7-727-2954448",
      "faxext" : "",
      "email" : "info@ps.kz",
      "registrar" : "ICPS",
      "create" : {
        "id" : "ICPS",
        "utc" : "2011-06-17T12:31:21Z",
        "unix" : "1308313881"
      },
      "update" : {
        "id" : "ICPS",
        "utc" : "2011-10-17T16:37:06Z",
        "unix" : "1318869426"
      }
    },
    "admin_handle" : "PS-KZ-000-000001",
    "admin_contact" : {
      "handle" : "PS-KZ-000-000001",
      "name" : "Regmaster",
      "org" : "TOO \"Internet-kompaniya PS\"",
      "street" : "ploschad' Respubliki 15, office 121, 124",
      "city" : "Almaty",
      "sp" : "Almaty",
      "pc" : "050013",
      "cc" : "KZ",
      "voice" : "7-727-2954448",
      "voiceext" : "",
      "fax" : "7-727-2954448",
      "faxext" : "",
      "email" : "info@ps.kz",
      "registrar" : "ICPS",
      "create" : {
        "id" : "ICPS",
        "utc" : "2011-06-17T12:31:21Z",
        "unix" : "1308313881"
      },
      "update" : {
        "id" : "ICPS",
        "utc" : "2011-10-17T16:37:06Z",
        "unix" : "1318869426"
      }
    },
    "nameservers" : {
      "ns" : [
        "ns.ps.kz",
        "ns1.ps.kz"
      ]
    },
    "statuses" : {
      "status" : [
        "clientTransferProhibited",
        "clientDeleteProhibited"
      ]
    },
    "expire" : {
      "utc" : "2012-08-17T18:00:00Z",
      "unix" : "1345226400"
    },
    "create" : {
      "id" : "KAZNIC",
      "utc" : "2003-08-18T11:20:09Z",
      "unix" : "1061205609"
    },
    "update" : {
      "id" : "ICPS",
      "utc" : "2011-10-03T20:45:23Z",
      "unix" : "1317674723"
    },
    "transfer" : {
      "utc" : "2009-05-13T08:23:30Z",
      "unix" : "1242203010"
    },
    "srvloc" : {
      "sp" : "Almaty",
      "city" : "Almaty",
      "street" : "pl. Respubliki, 15"
    }
  }
}
Возможные ошибки:
Ошибки при выполнении запроса:
Данные ошибки выводятся в корне ответа.
Error_code Error_text Описание
PURCHASES_DISABLED Purchases disabled for this account. Покупки/заказы для этого лицевого счёта запрещены.
DOMAIN_ALREADY_EXISTS Domain already exists, use whois service Домен уже существует, проверьте через whois
DOMAIN_CONTACT_NOT_EXISTS Domain contact handle does not exists. Доменный контакт с указанным handle не существует.
DOMAIN_BAD_NAME Invalid domain name Недопустимое имя для домена
PARAMETER_INCORRECT Given parameter has an invalid format or value or is missing. Переданный параметр имеет неверный формат, значение или отсутствует.

blog comments powered by Disqus