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

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

Назначение:
Получение регистрационных данных домена .kz (whois)
Поля запроса:
name desc
dname Доменное имя
contact_whois Необязательный параметр, определяющий нужно ли получать подробные данные контактов.
Может равняться 1 или 0 (по-умолчанию).
Поля ответа:
name desc
dname Доменное имя
registrar Имя компании, которая обслуживает домен. (Регистратор)
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 - адрес.
Пример:
Описание:
Получаем WHOIS данные для домена ps.kz

Запрос:
GET JSON XML
https://api.ps.kz/kzdomain/domain-whois?username=test&password=test
&input_format=http&output_format=json
&dname=old.ps.kz
&contact_whois=1

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array 
{
  "result" : "success",
  "answer" : {
    "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"
    }
  }
}
Пример:
Описание:
Для недавно удаленного домена будет возвращен следующий ответ с ошибкой

Запрос:
GET JSON XML
https://api.ps.kz/kzdomain/domain-whois?username=test&password=test
&input_format=http&output_format=json
&dname=deleted-domain.kz

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array 
{
  "result" : "error",
  "error_text" : "Domain name not available",
  "error_code" : "DOMAIN_NOT_AVAILABLE",
  "error_data" : {
    "dname" : "deleted-domain.kz",
    "info" : "Domain name deleted-domain.kz holded until 2017-04-02",
    "hold_until" : "2017-04-02"
  }
}
Возможные ошибки:
Ошибки при выполнении запроса:
Данные ошибки выводятся в корне ответа.
Error_code Error_text Описание
DOMAIN_NOT_REGISTRED Domain name not registred Доменное имя не зарегистрировано
DOMAIN_BAD_NAME Invalid domain name Недопустимое имя для домена
DOMAIN_CONNECTION_FAILED Unable to establish connection with the registry of domain names. Try again later. Невозможно установить соединение с регистратурой доменных имён. Попробуйте повторить попытку позднее.
DOMAIN_NOT_AVAILABLE Domain name not available Доменное имя не доступно для регистрации

blog comments powered by Disqus