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

Назначение:

Проверка доступности регистрации домена .kz

Поля запроса:

name	desc
dname	Доменное имя или список доменных имён.

Поля ответа:

name	desc
domains	Список элементов, который содержит имена доменов dname и их доступность. Если домен свободен, то поле result будет иметь значение Available.

Пример:

Запрос:

GET JSON XML

https://api.ps.kz/kzdomain/domain-check?username=test&password=test
&input_format=http&output_format=json
&dname=test-any-domain.kz

https://api.ps.kz/kzdomain/domain-check?username=test&password=test
&input_format=json&output_format=json
&input_data=

{
  "dname" : "test-any-domain.kz"
}

https://api.ps.kz/kzdomain/domain-check?username=test&password=test
&input_format=xml&output_format=json
&input_data=

<data>
   <dname>test-any-domain.kz</dname>
</data>

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array

{
  "result" : "success",
  "answer" : {
    "domains" : [
      {
        "dname" : "test-any-domain.kz",
        "result" : "Available"
      }
    ]
  }
}

Пример:

Запрос:

GET JSON XML

https://api.ps.kz/kzdomain/domain-check?username=test&password=test
&input_format=http&output_format=json
&dname%5B0%5D=test-nod-123.kz
&dname%5B1%5D=go.cn
&dname%5B2%5D=a.kz
&dname%5B3%5D=
&dname%5B4%5D=b.kz

https://api.ps.kz/kzdomain/domain-check?username=test&password=test
&input_format=json&output_format=json
&input_data=

{
  "dname" : [
    "test-nod-123.kz",
    "go.cn",
    "a.kz",
    "",
    "b.kz"
  ]
}

https://api.ps.kz/kzdomain/domain-check?username=test&password=test
&input_format=xml&output_format=json
&input_data=

<data>
   <dname>test-nod-123.kz</dname>
   <dname>go.cn</dname>
   <dname>a.kz</dname>
   <dname>
   </dname>
   <dname>b.kz</dname>
</data>

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array

{
  "result" : "success",
  "answer" : {
    "domains" : [
      {
        "dname" : "error_name.kz",
        "result" : "error",
        "error_code" : "DOMAIN_BAD_NAME",
        "error_text" : "Invalid domain name"
      },
      {
        "dname" : "test-nod-123.kz",
        "result" : "Available"
      },
      {
        "dname" : "go.cn",
        "result" : "error",
        "error_code" : "DOMAIN_BAD_TLD",
        "error_text" : "TLD is not supported"
      },
      {
        "dname" : "a.kz",
        "result" : "error",
        "error_code" : "DOMAIN_ALREADY_EXISTS",
        "error_text" : "Domain already exists, use whois service"
      },
      {
        "dname" : "b.kz",
        "result" : "error",
        "error_code" : "DOMAIN_NOT_AVAILABLE",
        "error_text" : "Domain name b.kz holded until 2017-04-02"
      }
    ]
  }
}

Возможные ошибки:

Ошибки проверки конкретного доменного имени:
Данные ошибки выводятся по пути answer > domains > domain > error_code.
При текущих ошибках корневой элемент result имеет значение success.

Error_code	Error_text	Описание
DOMAIN_ALREADY_EXISTS	Domain already exists, use whois service	Домен уже существует, проверьте через whois
DOMAIN_BAD_TLD	TLD is not supported	Неподдерживаемая зона для регистрации доменов
DOMAIN_INVALID_LENGTH	Invalid domain name length. You have entered too short or too long name	Недопустимая длина имени домена. Вы ввели либо слишком короткое, либо слишком длинное имя
DOMAIN_BAD_NAME	Invalid domain name	Недопустимое имя для домена
DOMAIN_NOT_AVAILABLE	Domain name not available	Доменное имя не доступно для регистрации